# GET /slots
URL: https://developers.vsee.io/api/slot-api/get/slots
operationId: listSlots
Auth: User Token — Requires a user access token from login or SSO.

List slots

Retrieve a list of slots with optional filtering by various criteria

Parameters:
- X-ApiToken (header, string, required) — API token
- X-AccountCode (header, string, required) — Account code
- start (query, integer, required) — UNIX timestamp for start of range
- end (query, integer, required) — UNIX timestamp for end of range
- status (query, integer, optional) — Filter by status. Use 10 for open slots
- type (query, string, optional) — Type of slot [enum: one, group]
- provider_id (query, string, optional) — Filter by provider ID
- room_code (query, string, optional) — Filter by room code
- account_code (query, string, optional) — Filter by account code
- specialty_id (query, string, optional) — Filter by specialty ID
- states_serviced (query, string, optional) — Filter by states serviced

Responses:
- 200 — List of slots
```json
{
  "data": [
    {
      "id": "63850640-129c-4e8a-af18-0b9f0a7d64b7",
      "provider_id": "9046",
      "account_code": "bac-team",
      "start": 1669836600,
      "end": 1669838400,
      "group_id": "63850640-2cf0-4822-a0bc-0b9f0a7d64b7",
      "status": 10,
      "modified": 1669662272,
      "created": 1669662272,
      "group": {
        "id": "63850640-2cf0-4822-a0bc-0b9f0a7d64b7",
        "date_start": "1669827600",
        "date_end": "1669913999",
        "time_start": "1669836600",
        "time_end": "1669838400",
        "repeat": false,
        "repeat_day": [],
        "repeat_week": 1,
        "account_code": "bac-team",
        "provider_id": "9046",
        "visit_type": "group",
        "timezone": "Asia/Ho_Chi_Minh"
      },
      "provider": {
        "id": "9046",
        "username": "bac+provider3@vseelab.com",
        "email": "bac+provider3@vseelab.com",
        "vseeid": "bac+provider3@vseelab.com",
        "full_name": "Bac Provider3 (edited)"
      }
    }
  ]
}
```