Get Time Off

Retrieve a single time-off request by ID.

Endpoint

GET /v1/staff/time-off/{id}

Authentication

Requires an API key with the staff:read scope.

Path Parameters

Parameter	Type	Description
id	integer	Time-off request ID

Response

Success (200 OK)

{
  "data": {
    "id": 7,
    "staff_id": 5,
    "staff": { "id": 5, "first_name": "Jane", "last_name": "Smith" },
    "start_date": "2026-04-14",
    "end_date": "2026-04-16",
    "start_time": null,
    "end_time": null,
    "is_all_day": true,
    "type": "annual_leave",
    "status": "pending",
    "reason": "Easter break",
    "approved_by": null,
    "created_at": "2026-04-01T09:00:00+00:00",
    "updated_at": "2026-04-01T09:00:00+00:00"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-04-01T10:00:00+00:00"
  }
}

Errors

Status	Code	Description
401	authentication_required	No API key provided
401	invalid_api_key	Invalid API key
403	insufficient_scope	API key lacks staff:read scope
404	not_found	Request not found or belongs to another supplier

Example Request

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