booking-com

opencollection: 1.0.0
info:
  name: Booking.com Demand API
  version: '3.1'
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: Accommodations
    type: folder
  items:
  - info:
      name: Search accommodations
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/accommodations/search
      body:
        type: json
        data: '{}'
    docs: Returns the cheapest available product for each accommodation that matches the specified search criteria. When location
      filters such as country or region ID are applied, results are sorted by Booking.com popularity instead of price. Results
      include product availability, price, and charges by default.
  - info:
      name: Get accommodation details
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/accommodations/details
      body:
        type: json
        data: '{}'
    docs: Returns detailed information on all accommodation properties matching the given criteria including property descriptions,
      facilities, photos, location data, and policies.
  - info:
      name: Check accommodation availability
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/accommodations/availability
      body:
        type: json
        data: '{}'
    docs: Checks availability for a specific accommodation, returning detailed product availability, pricing, and extra charges.
      The checkin date must be within 500 days and checkout must be between 1 and 90 days after checkin.
  - info:
      name: Check multiple accommodation availability
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/accommodations/bulk-availability
      body:
        type: json
        data: '{}'
    docs: Checks availability for multiple accommodations at once. Accepts an array of accommodation IDs along with dates,
      guest information, and optional filters for meal plan and cancellation type.
  - info:
      name: Get accommodation reviews
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/accommodations/reviews
      body:
        type: json
        data: '{}'
    docs: Retrieves traveler reviews for specified accommodations, providing feedback associated with particular properties.
      Reviews can be filtered by reviewer parameters and languages.
  - info:
      name: Get accommodation review scores
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/accommodations/reviews/scores
      body:
        type: json
        data: '{}'
    docs: Returns score distribution and score breakdown for the specified accommodations. The scores information can be filtered
      by reviewer parameters and languages.
  - info:
      name: Get accommodation chains
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/accommodations/chains
      body:
        type: json
        data: '{}'
    docs: Retrieves information about hotel chains and brand affiliations for accommodations listed on Booking.com.
- info:
    name: Constants
    type: folder
  items:
  - info:
      name: Get accommodation constants
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/accommodations/constants
      body:
        type: json
        data: '{}'
    docs: Retrieves reference data constants including accommodation types, accommodation facilities, accommodation themes,
      bed types, charge types, facility types, review scores, room facilities, and room types.
- info:
    name: Orders
    type: folder
  items:
  - info:
      name: Preview an order
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/orders/preview
      body:
        type: json
        data: '{}'
    docs: Generates a preview of an order before creation, allowing the traveler to review the booking details, pricing, and
      policies before committing.
  - info:
      name: Create an order
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/orders/create
      body:
        type: json
        data: '{}'
    docs: Creates a new booking order, allowing travelers to book and pay for travel services and products directly from the
      affiliate application. Manages bookings efficiently without redirecting users to Booking.com.
  - info:
      name: Get order details
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/orders/details
      body:
        type: json
        data: '{}'
    docs: Retrieves relevant booking details for a specific order, including status, pricing, guest information, and accommodation
      details.
  - info:
      name: Cancel an order
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/orders/cancel
      body:
        type: json
        data: '{}'
    docs: Processes the cancellation of an existing order. Cancellation policies and any applicable fees are determined by
      the property and rate plan.
- info:
    name: Messages
    type: folder
  items:
  - info:
      name: Send a message
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/messages/send
      body:
        type: json
        data: '{}'
    docs: Sends a message within a conversation. The message body supports plain text and optionally allows attaching a file
      by referencing a previously uploaded attachment ID.
  - info:
      name: Fetch latest messages
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/messages/latest
      body:
        type: json
        data: '{}'
    docs: Retrieves up to 100 of the most recent messages from a specified conversation, including messages from both property
      and guest, returned in reverse chronological order (newest first). Can be used to sync message threads or poll for updates.
  - info:
      name: Confirm message receipt
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/messages/latest/confirm
      body:
        type: json
        data: '{}'
    docs: Confirms receipt of specified messages. This confirmation is required before receiving new messages from the POST
      /messages/latest endpoint.
- info:
    name: Conversations
    type: folder
  items:
  - info:
      name: List conversations
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/conversations/list
      body:
        type: json
        data: '{}'
    docs: Retrieves a list of messaging conversations, allowing you to browse and manage communication threads between guests
      and properties.
  - info:
      name: Get conversation details
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/conversations/details
      body:
        type: json
        data: '{}'
    docs: Fetches detailed information about a specific conversation, including participants, message count, and status.
- info:
    name: Payments
    type: folder
  items:
  - info:
      name: Get supported currencies
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/payments/currencies
      body:
        type: json
        data: '{}'
    docs: Retrieves the list of currencies supported for payments on Booking.com, including currency codes and display information.
  - info:
      name: Get payment types
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/payments/types
      body:
        type: json
        data: '{}'
    docs: Retrieves the list of payment types supported on Booking.com, including credit cards and other payment methods.
- info:
    name: Locations
    type: folder
  items:
  - info:
      name: Get countries
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/locations/countries
      body:
        type: json
        data: '{}'
    docs: Retrieves geographical location data for countries supported on Booking.com.
  - info:
      name: Get cities
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/locations/cities
      body:
        type: json
        data: '{}'
    docs: Retrieves geographical location data for cities, including city identifiers used in accommodation search queries.
  - info:
      name: Get regions
      type: http
    http:
      method: POST
      url: https://demandapi.booking.com/3.1/locations/regions
      body:
        type: json
        data: '{}'
    docs: Retrieves geographical location data for regions, including region identifiers used in accommodation search queries.
bundled: true