List Timetables

Retrieve every timetable belonging to your organisation.

Endpoint

GET /api/v1/timetables

Also available at GET /api/partner/v1/timetables for ERP partners. Both paths return the same payload.

Authentication

Authorization: Bearer ttm_YOUR_API_KEY

See Authentication.

Parameters

None.

Response

{
  "success": true,
  "data": {
    "orgId": "6913…",
    "count": 2,
    "timetables": [
      {
        "id": "6a34108b1d16898202940188",
        "name": "Term 1 2026",
        "status": "published",
        "versionNumber": 3,
        "createdAt": "2026-07-01T09:12:00.000Z",
        "updatedAt": "2026-08-20T16:40:00.000Z"
      }
    ]
  },
  "timestamp": "2026-09-14T10:00:00.000Z"
}

Field	Type	Notes
id	string	Pass to Get Timetable
name	string	May be null if the timetable has not been named
status	string	draft or published. Only publish published timetables to staff
versionNumber	number	Increments as new versions are generated

Example

curl -H "Authorization: Bearer ttm_YOUR_API_KEY" \
  https://api.timetablemaster.com/api/v1/timetables

Errors

Status	Code	Meaning
401	INVALID_API_KEY	Missing, invalid, expired or revoked key
500	INTERNAL_ERROR	Unexpected server error