Skip to main content

List Schedule Templates

Retrieve all saved schedule templates for the authenticated supplier.

Endpointโ€‹

GET /v1/staff/schedule/templates

Authenticationโ€‹

Requires an API key with the staff:read scope.

Responseโ€‹

Success (200 OK)โ€‹

{
"data": [
{
"id": 1,
"name": "Summer Roster",
"shift_count": 14,
"created_at": "2026-03-01T10:00:00+00:00",
"updated_at": "2026-03-01T10:00:00+00:00"
},
{
"id": 2,
"name": "Off-Season Roster",
"shift_count": 8,
"created_at": "2026-01-15T08:30:00+00:00",
"updated_at": "2026-01-15T08:30:00+00:00"
}
],
"meta": {
"request_id": "req_abc123",
"timestamp": "2026-04-01T09:00:00+00:00"
}
}

Response Fieldsโ€‹

FieldTypeDescription
idintegerTemplate ID
namestringTemplate name
shift_countintegerNumber of shifts stored in this template
created_atstringISO 8601 datetime
updated_atstringISO 8601 datetime

Errorsโ€‹

StatusCodeDescription
401authentication_requiredNo API key provided
401invalid_api_keyInvalid API key
403insufficient_scopeAPI key lacks staff:read scope

Example Requestโ€‹

curl -X GET "https://app.equipdash.com/api/v1/staff/schedule/templates" \
-H "Authorization: Bearer eqd_live_abc123xyz789..."