Get Shift

Retrieve a single staff shift by ID.

Endpoint

GET /v1/staff/shifts/{id}

Authentication

Requires an API key with the staff:read scope.

Path Parameters

Parameter	Type	Description
id	integer	The shift ID

Response

Success (200 OK)

{
  "data": {
    "id": 1,
    "staff": {
      "id": 5,
      "first_name": "Jane",
      "last_name": "Smith"
    },
    "staff_id": 5,
    "location": {
      "id": 2,
      "name": "Beach Location"
    },
    "location_id": 2,
    "shift_date": "2026-03-15",
    "start_time": "09:00:00",
    "end_time": "17:00:00",
    "duration_calculation": "8 hours",
    "break_setting": true,
    "break_type": "lunch_break",
    "break_time": "30",
    "break_payment": "paid",
    "shift_notes": "Morning briefing at 8:45",
    "status": "Published",
    "publish_type": null,
    "created_at": "2026-03-10T08:00:00+00:00",
    "updated_at": "2026-03-10T08:00:00+00:00"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-03-10T12: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
403	forbidden	Shift belongs to a different supplier
404	not_found	Shift not found

Example Request

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