Sign in
Students

Get all students

Changed on

Retrieve a paginated list of students with optional filtering by grade, therapist, and name

get/students

Request

  • Base URL: http://localhost:8080/api/v1
  • URL: http://localhost:8080/api/v1/students
  • Auth: none declared

Query parameters

pageinteger
Example:1

Page number for pagination (starts at 1)

limitinteger
Example:10

Number of students per page

gradeinteger
Example:5

Filter students by grade level (exact match). -1 = graduated, 0 = kindergarten, 1-12 = grades 1-12

therapist_idstring uuid
Example:9dad94d8-6534-4510-90d7-e4e97c175a65

Filter students by therapist UUID

school_idinteger
Example:2

Filter students by school ID

namestring
Example:John

Search students by name (case-insensitive, matches first or last name)

Response

Successful response with list of students

idstring uuid required

Unique identifier for the student

first_namestring required

Student's first name

last_namestring required

Student's last name

dobstring date-time

Student's date of birth

therapist_idstring uuid required

UUID of the assigned therapist

school_idinteger required

ID of the school the student attends

school_namestring nullable

Name of the school the student attends

district_idinteger nullable

ID of the school district the student belongs to

gradeinteger nullable

Student's current grade level. -1 = graduated, 0 = kindergarten, 1-12 = grades 1-12

iepstring[] nullable

List of Individualized Education Program goals

created_atstring date-time required

Timestamp when the student record was created

updated_atstring date-time required

Timestamp when the student record was last updated

Example response

[
  {
    "id": "843d4807-1397-4227-9328-330adea56993",
    "first_name": "John",
    "last_name": "Doe",
    "dob": "2010-05-15T00:00:00Z",
    "therapist_id": "9dad94d8-6534-4510-90d7-e4e97c175a65",
    "school_id": 3,
    "school_name": "Generate High",
    "district_id": 2,
    "grade": 5,
    "iep": [
      "Active IEP with speech therapy goals",
      "Occupational therapy accommodations"
    ],
    "created_at": "2025-09-18T14:14:11.66268Z",
    "updated_at": "2025-09-18T14:14:11.66268Z"
  }
]

Changes

  • ec921aa9dc08Revision changes
    • ▲

      the / response's property type changed from string to array for status

  • e8df156eaed6Revision changes
    • ○

      added the new optional query request parameter school_id

    • ○

      added the optional property / to the response with the status

    • ○

      added the optional property / to the response with the status

    • ○

      added the required property / to the response with the status