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.

Request

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

Parameters

Example: Full Sync

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

Example: Incremental Sync

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.

Response

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

Incremental Sync Pattern

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