Confirm message receipt

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

Retrieve latest messages

Request

3.2 Beta

Use this endpoint to fetch the most recent messages in a specific conversation, including messages sent by both the property and the guest. By default, up to 100 messages are returned in reverse chronological order (newest first).

This endpoint is ideal for:

Synchronising message threads between your system and the Booking.com platform.
Polling for updates to detect new messages since your last request.

Best practice:
Use the timestamp or message IDs from previous responses to avoid fetching duplicate messages when syncing conversations. Use this to sync message threads or poll for updates.

Headers

X-Affiliate-Idintegerrequired

Include here your Affiliate identifier number

Bodyapplication/json

any

curl -i -X POST \
  https://demandapi.booking.com/3.2/Beta/messages/latest \
  -H 'Authorization: Bearer <YOUR_string_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-Affiliate-Id: 0' \
  -d '{}'

Responses

Successful response.

Bodyapplication/json

request_idstring

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

dataobject

Response

application/json

{
  "request_id": "0248d85a-17e0-44b3-a37c-7d4b5c03f58b",
  "data": {
    "messages": [ … ]
  }
}

Confirm message receipt

Request

| 3.2 Beta | Changed |

Use this endpoint to confirm receipt of messages.

Important: This confirmation is required before receiving new messages from the POST /messages/latest endpoint.

Headers

X-Affiliate-Idintegerrequired

Include here your Affiliate identifier number

Bodyapplication/jsonrequired

messagesArray of strings

curl -i -X POST \
  https://demandapi.booking.com/3.2/Beta/messages/latest/confirm \
  -H 'Authorization: Bearer <YOUR_string_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-Affiliate-Id: 0' \
  -d '{
    "messages": [
      "8586a789-44f4-5521-9f27-f5efd097cba"
    ]
  }'

Responses

Successful response.

Bodyapplication/json

request_idstring

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

confirmedMessagesArray of strings

Response

application/json

{
  "request_id": "cdb0b154-2eae-481b-8fee-fb2725296e1f",
  "confirmedMessages": [
    "8586a789-44f4-5521-9f27-f5efd097cba"
  ]
}

Conversations

Provides endpoints to retrieve and manage messaging conversations.

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

Operations

Attachments

Provides endpoints for handling message attachments.

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

Operations