# Get a List of Time Slots Available for Booking

The sessions available for booking object has the following fields:
| Field | Type | Description |
|  --- | --- | --- |
| time | string | Session time (17:30 for example) |
| session_length | number | Session duration in seconds |
| datetime | datetime | Date and time of the session in ISO8601 format (must be passed when creating the appointment) |

The following filters are available:
+ service_ids: Array of service IDs. If you need sessions, when can you book these services

Endpoint: GET /book_times/{location_id}/{team_member_id}/{date}
Version: 1.0.0
Security: BearerPartner

## Security:

  - `BearerPartner` (unknown)
    http bearer Bearer {PartnerToken}

## Path parameters:

  - `location_id` (number, required)
    location ID

  - `date` (string, required)
    date in iso8601 format.
Filter by booking date (eg '2026-09-30')

  - `team_member_id` (number, required)
    team member ID. Filter by team member ID
Default: 0

## Query parameters:

  - `service_ids[]` (string)
    Service ID.
Filter by the list of service identifiers

  - `exclude_record_id` (number)
    ID of an existing Appointment that is being rescheduled.
When set, the search also accepts Services that are no longer available for online booking, so the Appointment can be moved even if its Service was switched offline. The Appointment's current time still counts as busy.

## Header parameters:

  - `Accept` (string, required)
    e.g. application/vnd.api.v2+json

  - `Content-Type` (string, required)
    application/json

  - `Authorization` (string, required)
    Bearer partner_token

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `success` (boolean)
    Execution success status (true)

  - `data` (array)
    Array of objects with data

  - `data.time` (string)
    Session time (HH:MM format)

  - `data.seance_length` (number)
    Session duration in seconds

  - `data.sum_length` (number)
    Total duration including all selected services in seconds

  - `data.datetime` (string)
    Session date and time in ISO 8601 format

  - `meta` (array)
    Metadata (empty array)

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `success` (boolean)
    Response status.
    Example: false

  - `data` (object | null)
    Response data.
    Example: null

  - `meta` (object)
    Additional response data.

  - `meta.message` (string)
    Error message.
    Example: Authentication needed.

## Response 403:

  - `403` (unknown)
    Forbidden

## Response 403 fields (application/json):

  - `success` (boolean)
    Response status.
    Example: false

  - `data` (object | null)
    Response data.
    Example: null

  - `meta` (object)
    Additional response data.

  - `meta.message` (string)
    Error message.
    Example: Access denied.

## Response 404:

  - `404` (unknown)
    Not Found

## Response 404 fields (application/json):

  - `success` (boolean)
    Response status.
    Example: false

  - `data` (object | null)
    Response data.
    Example: null

  - `meta` (object | array)
    Additional response data (empty object or empty array)
    Example: {}