# Get bookings

Retrieves a list of your bookings. You can filter the results by , , guest information (, , , ), , and . 

Pagination is also supported.


Endpoint: GET /v2/bookings
Version: 2.1
Security: Authorization

## Query parameters:

  - `date_start` (string)
    date_start - As compared with arrivalDate, format YYYY-MM-DD

  - `date_end` (string)
    date_end - As compared with arrivalDate, format YYYY-MM-DD

  - `first_name` (string)
    first_name - Guest's first name

  - `last_name` (string)
    last_name - Guest's last name

  - `email` (string)
    email - Guest's email address

  - `phone` (string)
    phone - Guest's contact number

  - `partner_reference` (string)
    partner_reference - The given unique partnerReference ID of booking

  - `page` (integer)
    page - Page number for results

  - `per_page` (integer)
    per_page - How many results per page - if not provided default value from user account will be used

  - `query` (string)
    query - Free phrase for text search for example &query=John

  - `status` (string)
    status - Filter bookings by status reserved|waiting|cancellation_requested|cancelled|approved|expired|rejected|refunded|refund_declined

## Response 200 fields (application/json):

  - `data` (array)

  - `data.uuid` (string)
    UUID of the booking

  - `data.code` (string)
    7 alphanumeric booking code

  - `data.partnerReference` (string)
    External booking reference from partner

  - `data.status` (string)
    booking status (reserved, waiting, approved, canceled, expired, rejected)

  - `data.createdAt` (string)
    created date/time

  - `data.updatedAt` (string)
    last updated date/time

## Response 401 fields (application/json):

  - `message` (string)
    A human-readable error message.

  - `code` (string)
    An internal error code.

  - `http_code` (integer)
    Http Status Code

## Response 404 fields (application/json):

  - `message` (string)
    A human-readable error message.

  - `code` (string)
    An internal error code.

  - `http_code` (integer)
    Http Status Code

## Response 405 fields (application/json):

  - `message` (string)
    A human-readable error message.

  - `code` (string)
    An internal error code.

  - `http_code` (integer)
    Http Status Code