POST /v1/sections — Get Sections by State IDs

Retrieve student records by their state IDs. Supports incremental sync using the changesSince parameter to only fetch records that have changed.

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

{
  "stateIds": ["1234567890", "1234567891", "1234567892"]
}

To retrieve only records that have changed since your last sync:

{
  "stateIds": ["1234567890", "1234567891"],
  "changesSince": "2026-01-15T00:00:00Z"
}

The changesSince parameter is an ISO 8601 date string. Only records modified after this date will be included in the response. This is useful for nightly sync jobs that only need to fetch updated records.

The response contains the same structure as /v1/students — keyed student objects with related schools, districts, and avatars.

1. On first sync, call without changesSince to get all records
2. Store the current timestamp
3. On subsequent syncs, pass the stored timestamp as changesSince
4. Merge/update your local data with the returned records