POST /v1/schedules — Search Schedules

Search master schedules for course offerings, sections, and assignments within your authorized scope.

Request

POST https://api.triand.com/v1/schedules
Content-Type: application/json
x-api-key: {your-api-key}
Authorization: Bearer {your-pjwt-token}

Parameters

Parameter	Business Rule / Regex	Description
limit	number, 1-100	Maximum number of schedule records to return (default: 25)
q	string	Search query — supports plain text and advanced field:value syntax
districtlea	string	District LEA code to search within
schoolleas	string[]	Array of school LEA codes to filter by
grades	string[]	Array of grade levels to filter by
subjects	string[]	Array of subject codes to filter by

Advanced Search Syntax

The q parameter supports field:value queries similar to the staff endpoint:

teacher:smith — Search by teacher name
course:algebra — Search by course name
period:3 — Search by class period
Plain text searches across all indexed fields

Example Request

{
  "limit": 20,
  "q": "course:algebra",
  "districtlea": "1503000",
  "grades": ["09", "10"]
}

Response

Returns schedule records with course details, teacher assignments, and enrollment counts.

{
  "actionOk": true,
  "error": [],
  "total": 5,
  "schedules": {
    "S001": {
      "courseName": "Algebra I",
      "courseCode": "MTH101",
      "period": "3",
      "teacherName": "Johnson, Robert",
      "enrollmentCount": 28,
      "grade": "09",
      "schoolPk": 987
    }
  },
  "courses": {
    "MTH101": { "name": "Algebra I", "subject": "Mathematics", "credits": 1.0 }
  }
}