Docs/Channels/Booking.com

Booking.com Reservations

Pull new and modified Booking.com reservations, get one reservation's details, and acknowledge the ones you have processed. Responses are Booking.com's raw reservation payloads; for the unified shape use GET /v1/reservations?platform=booking.

GET/v1/channels/booking/reservations

Parameters

typestring

new (default, not yet acknowledged) | modified | details

hotel_idstring

Booking.com property id (alias property_id). Filters new / modified; required with reservation_id for details.

reservation_idstring

With hotel_id, returns that reservation's details.

Scope

hotel_id must be a property connected to your workspace; any other id returns 404 not_found, the same as an id that does not exist.
Without hotel_id, new and modified cover only your workspace's own Booking.com properties, and return 404 not_found if it has none.
A reservation_id that belongs to another workspace returns 404 not_found.
Acknowledge with POST and {"reservation_ids": [...]} once you have stored each reservation. If any id is not one of your workspace's Booking.com reservations, nothing is acknowledged and 404 not_found names those ids.

Example

# New (unacknowledged) reservations
curl https://api.repull.dev/v1/channels/booking/reservations \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

# One reservation's details
curl "https://api.repull.dev/v1/channels/booking/reservations?type=details&hotel_id=1234567&reservation_id=4218850692" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

# Acknowledge after storing them
curl -X POST https://api.repull.dev/v1/channels/booking/reservations \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reservation_ids": ["4218850692"]}'

Previous← Guest Messaging NextReviews →