REST API · v1

The student data API built for special education

SpedHub gives developers a structured, reliable REST API to store and retrieve IEP-related student records — disabilities, services, goals, and accommodations — with a single integration.

Read the Docs View API Reference

200 OKGET /students/:id

{
  "id": "stu_01hx9k2m3n4p5q6r7s8t",
  "firstName": "Jordan",
  "lastName": "Rivera",
  "gradeLevel": "4",
  "gender": "non-binary",
  "disabilities": [
    "Specific Learning Disability",
    "Speech or Language Impairment"
  ],
  "services": [
    "Resource Room (Math)",
    "Speech-Language Therapy"
  ],
  "goals": [
    {
      "area": "Reading Fluency",
      "benchmark": "80 wpm by Q3"
    }
  ],
  "accommodations": [
    "Extended time (1.5x)",
    "Preferential seating",
    "Text-to-speech"
  ]
}

Endpoints

Full CRUD. Predictable responses.

GET/students

Retrieve a paginated list of all student records.

GET/students/:id

Fetch a single student record by unique ID.

POST/students

Create a new student record with full schema.

PUT/students/:id

Update an existing student record by ID.

DELETE/students/:id

Permanently remove a student record.

GET/students/:id/goals

Retrieve all IEP goals for a specific student.

Data model

Student object

Every student record conforms to this schema. All fields are returned on GET requests.

FieldTypeRequiredDescription

idstringyesUnique identifier (UUID v4)

firstNamestringyesStudent's legal first name

lastNamestringyesStudent's legal last name

gradeLevelstringyesGrade level (e.g. K, 1–12)

genderstringnoGender identity as reported

disabilitiesstring[]noArray of disability classifications (IDEA categories)

servicesstring[]noArray of special education services provided

goalsobject[]noArray of IEP goal objects with benchmarks

accommodationsstring[]noArray of instructional and testing accommodations

Start building in minutes

Authenticate with an API key and make your first request. Full CRUD support, JSON responses, and predictable error codes.

curl

curl -X GET https://api.spedhub.dev/v1/students \
  -H "Authorization: Bearer sk_live_••••••••" \
  -H "Content-Type: application/json"

Get API Key

No credit card required. Free tier available.