# Get Bookings

Get all bookings.

Endpoint: GET /v1/bookings
Version: 0.1.0
Security: OAuth2

## Query parameters:

  - `cursor` (string)
    The cursor for pagination.
An empty string indicates the start of the list.

  - `limit` (integer)
    The maximum number of bookings to return.

  - `from` (string)
    Filter bookings made after the provided timestamp.

  - `to` (string)
    Filter bookings made before the provided timestamp.

  - `sort` (string)
    Field to define the sort order. To indicate sorting direction, fields may be prefixed with  (ascending) or  (descending).

Ensure to URL escape the value as  can otherwise be interpreted as a space.

Only fields  and  are supported.

## Response 200 fields (application/json):

  - `next` (string)
    The cursor for the next page.
An empty string indicates the end of the list.

  - `items` (array)

  - `items.id` (string, required)
    The unique identifier of the booking.

  - `items.status` (string, required)
    The status of the booking.
    Enum: "ACTIVE", "CANCELLED", "MOVED", "PROCESSING", "CHECKED_IN", "UNKNOWN"

  - `items.created_at` (string, required)
    Timestamp of when the booking was created.

  - `items.updated_at` (string, required)
    Timestamp of when the booking was last updated.

  - `items.company_id` (string, required)
    The ID of the company hosting the experience.

  - `items.experience_id` (string, required)
    The unique identifier of the experience.

  - `items.event_id` (string, required)
    The unique identifier of the event.

  - `items.customer` (any, required)
    The customer that made the booking.

  - `items.locale` (string, required)
    Combination of language and country/region.
The format is a lowercase ISO 639-1 language code followed by an optional hyphen and an
uppercase ISO 3166-1 country code.

  - `items.source` (string)
    The source of the booking.

  - `items.internal_note` (string)
    Internal note for the booking.

  - `items.metadata` (object)
    Additional metadata for the booking.

This property lets you add custom data to the booking, e.g. your own booking reference.
The key has a limit of 40 characters and the value has a limit of 500 characters.

## Response 400 fields (application/json):

  - `message` (string, required)

  - `code` (string, required)

## Response default fields (application/json):

  - `message` (string, required)

  - `code` (string, required)