Guide Picker

Returns all supplier staff grouped into three availability buckets for a slot — available, partial, and unavailable. Mirrors the guide-picker dropdown shown in the scheduling UI.

Endpoint

GET /v1/experience-availability/{id}/guides/picker

Authentication

Requires an API key with the experiences:read scope.

Path Parameters

Parameter	Type	Description
id	integer	Experience availability slot ID

Response

Success (200 OK)

{
  "data": {
    "available": [
      { "id": 5, "name": "Jane Smith", "reason": null },
      { "id": 9, "name": "Carlos Ruiz", "reason": null }
    ],
    "partial": [
      { "id": 8, "name": "Tom Jones", "reason": "Has another shift ending 30 minutes before" }
    ],
    "unavailable": [
      { "id": 3, "name": "Sam Lee", "reason": "On approved leave" }
    ]
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-04-01T09:00:00+00:00"
  }
}

Response Fields

Each staff entry in all three groups contains:

Field	Type	Description
id	integer	Staff member ID
name	string	Full name
reason	string|null	Reason for partial availability or unavailability

Errors

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

Example Request

curl -X GET "https://app.equipdash.com/api/v1/experience-availability/12/guides/picker" \
  -H "Authorization: Bearer eqd_live_abc123xyz789..."