# Get bookings details

### Request 

<mark style="color:green;">**GET**</mark> &#x20;

{% code overflow="wrap" %}

```url
https://interface.experience-hotel.com/api/xp-bookings/details?bookings=15881517,15927394
```

{% endcode %}

Up to 25 reservations per call.

| Params   | Required | Format                                    |
| -------- | -------- | ----------------------------------------- |
| bookings | Required | List of bookings IDs separated by a comma |

### Response

Return: The details of the requested reservations

```json
{
  "bookings_details": [
    {
      "id": 15881517,
      "reference": "39",
      "status": "valid",
      "channel": "Manuel",
      "partner_establishment_id": null,
      "experience_hotelid": 189,
      "arrival_date": "2022-02-20",
      "arrival_time": null,
      "departure_date": "2022-02-26",
      "creation_date": "2019-04-01 00:00:00",
      "customer": {
        "id": 8863163,
        "email": "arrival1@progress9.com",
        "first_name": "Albert",
        "last_name": "Swift",
        "title": "Mme",
        "birthdate": "1986-04-03",
        "country": "MZ",
        "language": "km",
        "mobile": null,
        "street_number_and_name": null,
        "postal_code": null,
        "city": null,
        "state": null,
        "no_mail": true,
        "marketing_decline": false
      },
      "total_amount": 300,
      "rooms": [
        {
          "type": "Single",
          "quantity": 1,
          "numbers": null
        }
      ],
      "ratecode": null,
      "currency": "EUR",
      "adult_count": 2,
      "child_count": 0,
      "infant_count": 0
    }
  ]
}
```

### Structure of a booking

<table><thead><tr><th>Fields</th><th width="100">Type</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>Numeric</td><td>unique identifier of the reservation on the CRM Experience</td></tr><tr><td>reference</td><td>string</td><td>Unique reference of the reservation on the PMS or channel manager</td></tr><tr><td>channel</td><td>string </td><td>Name of the PMS or channel manager</td></tr><tr><td>partner_establishement_id</td><td>Numeric</td><td><p>Property ID at the partner. </p><p>If you need this field with your own ID, you can send us the list of properties with their ID at your place, and we can send it back to you for each reservation.</p></td></tr><tr><td>experience_hotelid</td><td>Numeric</td><td>Property ID in Experience CRM</td></tr><tr><td>arrival_date</td><td>string</td><td>YYYY-MM-DD</td></tr><tr><td>arrival_time</td><td>string</td><td><p>HH:MM:SS </p><p>The arrival time is given in the hotel's timezone.</p></td></tr><tr><td>departure_date</td><td>string</td><td>YYYY-MM-DD</td></tr><tr><td>creation_date</td><td>string</td><td><p>YYYY-MM-DD HH:MM:SS </p><p>Date the reservation was made.</p></td></tr><tr><td>customer</td><td>object</td><td>See structure of a customer</td></tr><tr><td>total_amount</td><td>float</td><td>Reservation total amount</td></tr><tr><td>rooms</td><td>object</td><td>See structure of a room</td></tr><tr><td>ratecode</td><td>string</td><td>Rate code</td></tr><tr><td>currency</td><td>string</td><td>Reservation currency</td></tr><tr><td>adult_count </td><td>float</td><td>Count of adults </td></tr><tr><td>child_count </td><td>float</td><td>Count of children</td></tr><tr><td>infant_count</td><td>float</td><td>Count of infants</td></tr></tbody></table>

### Customer Object&#x20;

<table><thead><tr><th>Fields</th><th width="100">Type</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>Numeric</td><td>Unique identifier of the customer</td></tr><tr><td>title</td><td>string</td><td>Title or civility of the customer </td></tr><tr><td>first_name</td><td>string</td><td>Firstname of the customer</td></tr><tr><td>last_name</td><td>string</td><td>Lastname of the customer</td></tr><tr><td>email</td><td>string</td><td>Email of the customer</td></tr><tr><td>mobile</td><td>string</td><td>mobile number in international format +33610111213</td></tr><tr><td>birthdate</td><td>string ($ISO 8601)</td><td>Birthdate of the customer</td></tr><tr><td>country</td><td>string ($ISO 3166-1 alpha-2)</td><td>Country of the customer</td></tr><tr><td>language</td><td>string ($ISO 639-1)</td><td>Language of the customer. </td></tr><tr><td>street_number_and_name</td><td>string</td><td>Customer's address street and number</td></tr><tr><td>postal_code</td><td>string</td><td>Customer's address postal code</td></tr><tr><td>state</td><td>string</td><td>Customer's address state</td></tr><tr><td>city</td><td>string</td><td>Customer's address city</td></tr><tr><td>no_mail</td><td>bool</td><td>Invalid email or refusal to receive any email</td></tr><tr><td>marketing_decline</td><td>bool</td><td>Refusal to receive marketing communications</td></tr></tbody></table>

### Room Object

<table><thead><tr><th>Fields</th><th width="100">Type</th><th>Description</th></tr></thead><tbody><tr><td>number</td><td>string</td><td>Name or number of the room </td></tr><tr><td>type</td><td>string</td><td><strong>Category</strong> name for the room, can be unique or not </td></tr><tr><td>quantity</td><td>int</td><td>Quantity of room booked</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://experience-crm.gitbook.io/experience-crm-api/reservations/bookings-retrieval/get-bookings-details.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.