Booking.com Demand API (3.2 Beta)

3.2 Beta

These endpoints are only available in Beta.

Limited access: This API is currently offered to a limited number of pilot affiliate partners. For inquiries regarding participation, please contact our partnerships team.
Active development: These are under active development and subject to change.
Frequent updates: These API specifications will be regularly updated throughout the pilot. We recommend checking the changelog page periodically for the latest changes.

Note: Authentication is required using your Affiliate ID and token credentials.

Download OpenAPI description

demand-api.json

demand-api.yaml

Servers

Production environment

https://demandapi.booking.com/3.2/Beta/

Sandbox environment

https://demandapi-sandbox.booking.com/3.2/Beta/

Car rentals

3.2 Beta

Find here only the new car rental endpoints, which are part of the 3.2 Beta version and still under active development.

Use these endpoints to test the complete Search, look, and book flow for car rentals, including checking availability, retrieving terms and conditions, and creating an order.
See Demand API version 3.2 for other car rental endpoints.

Important:

These endpoints are currently available only in the 3.2 Beta version, are under active development and may change in future releases.
Access is limited to partners participating in the pilot/early access programme. Contact your Booking.com Account manager to request more information.

Operations

Attractions

| 3.2 Beta | New |

The Attractions API collection introduces a new travel service asset within the Demand API.

Use these endpoints to search for attractions, retrieve detailed information, and store static data.

Important:

These endpoints are currently available only in the 3.2 Beta version, are under active development and may change in future releases.
Access is limited to partners participating in the pilot/early access programme. Contact your Booking.com Account manager to request more information.

Operations

Orders

| 3.2 Beta | Changed |

Find in this version only the order endpoints that provide support to the car rental booking.

Use these endpoints to preview and create new car rental orders, check car order details, cancel or modify car rental orders.
This collection is required to integrate booking and order management functionality with car rental.

Important:

These endpoints are also available in version 3.2 but without the car implementation.
Support to car rental booking is only available in the 3.2 Beta version, as are under active development and may change in future releases.
Access is limited to partners participating in the pilot/early access programme. Contact your Booking.com Account manager to request more information.

Operations

Messages

3.2 Beta

This API collection allows two-way post-booking communication between guests and properties and is currently available in the 3.2 Beta version.

Use these endpoints to test the complete communication flow, including sending and retrieving messages, conversations and attachments.

Important:

These endpoints are currently available only in the 3.2 Beta version, are under active development and may change in future releases.
Access is limited to partners participating in the pilot/early access programme. Contact your Booking.com Account manager to request more information.

Operations

Conversations

Provides endpoints to retrieve and manage messaging conversations.

Use these endpoints to list conversations, fetch conversation details, and track updates.

Operations

Retrieve a conversation

Request

3.2 Beta

Use this endpoint to retrieve a conversation available to the authenticated user, including message history and participants.

Headers

X-Affiliate-Idintegerrequired

Include here your Affiliate identifier number

Bodyapplication/jsonrequired

One of:

reservationstringrequired

Unique identifier of the reservation.

accommodationstringrequired

Unique identifier of the property.

curl -i -X POST \
  https://demandapi.booking.com/3.2/Beta/messages/conversations \
  -H 'Authorization: Bearer <YOUR_string_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-Affiliate-Id: 0' \
  -d '{
    "accommodation": "6819547",
    "conversation": "c3cc6522-aa63-559d-99f1-94efdd527c3c"
  }'

Responses

Conversation retrieved successfully.

Bodyapplication/json

request_idstringrequired

Uniquely identifies the request. Please provide this identifier when contacting support.

dataobjectrequired

data.conversationobjectrequired

data.conversation.idstringrequired

Unique identifier of the conversation.

data.conversation.reservationstring

The unique identifier of the reservation

data.conversation.messagesArray of objectsrequired

Chronological list of messages in the conversation.

data.conversation.messages[].idstringrequired

Unique identifier of the message.

data.conversation.messages[].senderstringrequired

Unique identifier of the sender (either property or guest).

data.conversation.messages[].contentstringrequired

Message content in plain text.

data.conversation.messages[].attachmentsArray of strings

List of attachment IDs included with the message (if any).

data.conversation.messages[].timestampstring(date-time)required

The timestamp in ISO-8601 format from which the message is sent. Format: YYYY-MM-DDTHH:mm:ss+00:00

data.conversation.participantsArray of objectsrequired

List of participants in the conversation, including guest and property.

data.conversation.participants[].idstringrequired

Unique identifier of the participant.

data.conversation.participants[].metadataobjectrequired

data.conversation.participants[].metadata.typestring

Type of the metadata

Enum"guest""property"

data.conversation.participants[].metadata.namestring

Uniquely identifies the metadata.

Response

application/json

{
  "request_id": "7889a8c0-aa43-494c-863d-72d2306849c1",
  "data": {
    "conversation": { … }
  }
}

Attachments

Provides endpoints for handling message attachments.

Use these endpoints to upload and download images shared within conversations.

Operations