> ## Documentation Index
> Fetch the complete documentation index at: https://dev.schoolcues.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Paging and changes

> Page through a resource, and read only what changed since your last sync.

## Lists

`GET /api/school/v1/{resource}` returns one page of a resource:

```json theme={null}
{
  "data": [{ "id": "...", "updatedAt": "2026-11-16T01:02:03.456Z" }],
  "total": 1240,
  "limit": 100,
  "offset": 0
}
```

| Query parameter | Meaning |
| - | - |
| `limit` | Records per page, a whole number from 1 to 500. The default is 100. |
| `offset` | How many records to skip. The default is 0. |
| `updatedSince` | Only records that changed after this time, in ISO 8601. |

Records come oldest change first, so a system keeps the latest `updatedAt` it has read and passes it as `updatedSince` next time.

## One record

`GET /api/school/v1/{resource}/{id}` returns `{ "data": { ... } }` for one record.

## Responses to handle

| Status | Meaning | What to do |
| - | - | - |
| `400` | A query parameter isn't valid. The message says which. | Fix the request. |
| `401` | The key is missing, revoked or expired. | Ask the school for a new key. |
| `403` | The key can't read this resource. | Ask the school for a key that can. |
| `404` | The resource or record doesn't exist. | Check the path. |
| `503` | SchoolCues couldn't check the key just now. | Retry after a short wait. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.