Skip to content
ORDERS/
/
Order details use cases
Last updated

Order details - Use cases

This page provides example /orders/details requests and responses for common use cases across travel services. Use these examples as reference payloads for integration testing and parsing.

Common use cases

Retrieve order details by reservation IDs

Scenario: Get details for a set of known reservations to check payments or commission calculations.

{
  "currency": "EUR",
  "reservations": [
    "2321873123",
    "4666773123"
  ],
  "sort": {
    "by": "updated",
    "direction": "descending"
  },
  "extras": [
    "payment"
  ]
}

Retrieve all orders created within a date range

Scenario: Get all new orders for cars and accommodations created between 1 and 7 September 2025 to sync with an internal CRM.

{
    "created": {
      "from": "2025-09-01T02:00:00+00:00",
      "to": "2025-09-07T02:00:00+00:00"
    },
    "currency": "EUR",
    "maximum_results": 20,
    "sort": {
      "by": "updated",
      "direction": "descending"
    },
    "services": ["cars", "accommodations"],
    "extras": [
      "payment"
    ]
  }

genius-bulb Use created.from and created.to to build incremental sync logic for systems that regularly update booking data.

Retrieve completed bookings for loyalty updates

Scenario: Get orders with stays that have ended between 1-7 February 2026 to credit loyalty points.

{
  "end": {
    "from": "2026-02-01",
    "to": "2026-02-07"
  },
  "currency": "EUR",
  "maximum_results": 20,
  "sort": {
    "by": "updated",
    "direction": "descending"
  },
  "extras": [
    "payment"
  ]
}

Response with loyalty reward and commission

Scenario: Check the loyalty reward amount, currency, type, and fulfilment details if your programme is enabled.

{
  "id": "xxxxxxxxxxxxxxx",
  "accommodations": {
    "reservation": 1234567890
  },
  "affiliate": 123456,
  "booker": {
    "address": {
      "city": "Amsterdam",
      "country": null
    },
    "email": "xxxxxxx@example.com",
    "name": {
      "first_name": "xxxxxx",
      "last_name": "xxxxxxxxxx"
    },
    "language": "en",
    "platform": "desktop",
    "telephone": "12345678",
    "travel_purpose": "unknown"
  },
  "commission": {
    "actual_amount": 17.5,
    "estimated_amount": null
  },
  "created": "2025-08-25T12:20:30+00:00",
  "currency": "EUR",
  "loyalty_reward": [
    {
      "amount": 15,
      "currency": "USD",
      "eligible": true,
      "fulfillment_at": "2025-10-10",
      "fulfillment_by": "partner",
      "loyalty_data": [
        {
          "name": "Email Id",
          "value": "john_doe@booking.com"
        },
        {
          "name": "Loyalty ID",
          "value": "10101010"
        }
      ],
      "type": "point"
    }
  ],
  "price": {
    "commissionable": 180.01,
    "total": 180.01
  },
  "status": "cancelled_by_guest",
  "updated": "2025-10-25T13:42:13+00:00"
}

Note: As this order was cancelled by the guest, commission is 0. See the cancellation guide for details.

Cancelled orders

A standard response for a cancelled order would be:


{
     "id": "xxxxxxxxxxxxxxx",
     "accommodations": {
         "reservation": 1234567890
     },
     "affiliate": 123456,
     "booker": {
         "address": {
             "city": "Amsterdam",
             "country": null
         },
         "email": "xxxxxxx@example.com",
         "name": {
             "first_name": "xxxxxx",
             "last_name": "xxxxxxxxxx"
         },
         "language": "en",
         "platform": "desktop",
         "telephone": "12345678",
         "travel_purpose": "unknown"
     },
     "commission": {
         "actual_amount": 0.00,
         "estimated_amount": null
     },
     "created": "2025-08-25T12:20:30+00:00",
     "currency": "EUR",
     ],
     "price": {
       "commissionable": 0.00,
       "total": 0.00
     },
     "status": "cancelled_by_guest",
     "updated": "2025-08-25T13:42:13+00:00"
},

Response examples by travel service

The /orders/details endpoint in Demand API v3.2 supports all connected trip services:

  • Accommodations
  • Cars
  • Flights
  • Attractions
  • Taxis

Retrieve combined multi-service trips

Scenario: Fetch orders that include multiple services (e.g., accommodation + car + flight) to track full-trip bookings.

 {
  "currency": "EUR",
  "services": ["accommodations", "cars", "flights"],
  "sort": {
    "by": "created",
    "direction": "descending"
  },
  "maximum_results": 50
}

✅ Supports full-trip reporting, cross-selling analysis, or bundled offer insights.

Accommodation reservation details

{
  "id": "509430129718799",
  "affiliate": 111111,
  "accommodations": {
    "reservation": 12345677,
    "name": "Test Booking Hotel USA",
    "location": {"address": "111 Street Road", "city": 20089219, "country": "us"},
    "number_of_guests": 2
  },
  "status": "booked",
  "price": {"commissionable_price": {"booker_currency": 160, "product_currency": 188.32},"total_price":{"booker_currency":170.01,"product_currency":200.1}}
}

Car reservation details

{
  "request_id": "01fr9ez700exycb98w90w5r9sh",
  "data": [
    {
      "id": "509430129718799",
      "affiliate": 111111,
      "accommodations": null
      },
      "cars": {
        "reservation": 9876543
      },
      "booker": {
        "name": {
          "first_name": "John",
          "last_name": "Doe"
        },
        "email": "johndoe@booking.com",
        "telephone": "+100000000",
        "language": "en-gb",
        "platform": "mobile",
        "travel_purpose": "business",
        "address": {
          "city": "Amsterdam",
          "country": "nl"
        }
      },
      "commission": {
        "actual_amount": 17.5,
        "estimated_amount": null
      },
      "currency": "EUR",
      "flights": null,
      "loyalty_reward": [null],
      "price": {
        "commissionable": 160,
        "total": 170.01
      },
      "status": "booked",
      "updated": "2025-07-28T02:00:00+00:00",
      "created": "2025-07-28T02:00:00+00:00"
    }
  ],
}

Attraction reservation details (v3.2)

{
  "order_id": "509430129718801",
  "attractions": {
    "reservation": 567890123,
    "name": "Eiffel Tower Guided Tour",
    "location": {"city": "Paris", "country": "fr"}
  },
  "affiliate": 111111,
  "booker": {
    "address": {"city": "Amsterdam", "country": "nl"},
    "email": "janedoe@booking.com",
    "name": {"first_name": "Jane", "last_name": "Doe"},
    "platform": "desktop",
    "telephone": "+100000001",
    "language": "en-gb",
    "travel_purpose": "leisure"
  },
  "commission": {"actual_commission_amount": {"booker_currency": 5.0, "product_currency": 6.0}},
  "currencies": {"booker": "EUR", "product": "EUR"},
  "price": {"commissionable_price": {"booker_currency": 50, "product_currency": 60}, "total_price": {"booker_currency": 55, "product_currency": 66}},
  "status": "booked",
  "start": "2026-07-10T09:00:00+00:00",
  "end": "2026-07-10T12:00:00+00:00",
  "created": "2025-11-28T02:00:00+00:00",
  "updated": "2025-11-28T02:00:00+00:00"
}

Flight reservation details (v3.2)

Scenario: Retrieve flight order details to verify itineraries and commission.

{
  "request_id": "02fr8fz701abcde98w91x6y7za",
  "data": [
    {
      "id": "609430129718800",
      "affiliate": 222222,
      "flights": {
        "reservation": "FL123456789",
        "itineraries": [
          {
            "departure": {
              "airport": "AMS",
              "datetime": "2026-06-01T10:00:00+00:00"
            },
            "arrival": {
              "airport": "JFK",
              "datetime": "2026-06-01T16:00:00+00:00"
            }
          },
          {
            "departure": {
              "airport": "JFK",
              "datetime": "2026-06-15T18:00:00+00:00"
            },
            "arrival": {
              "airport": "AMS",
              "datetime": "2026-06-16T06:00:00+00:00"
            }
          }
        ]
      },
      "booker": {
        "name": { "first_name": "Alice", "last_name": "Smith" },
        "email": "alice.smith@example.com",
        "telephone": "+31123456789",
        "language": "en-gb",
        "platform": "desktop",
        "travel_purpose": "business",
        "address": { "city": "Amsterdam", "country": "nl" }
      },
      "commission": {
        "actual_commission_amount": { "booker_currency": 45.5, "product_currency": 50.0 },
        "actual_percentage": 10.0,
        "estimated_commission_amount": { "booker_currency": null, "product_currency": null }
      },
      "currencies": { "booker": "EUR", "product": "USD" },
      "price": {
        "commissionable_price": { "booker_currency": 455, "product_currency": 500 },
        "total_price": { "booker_currency": 500, "product_currency": 550 }
      },
      "start": "2026-06-01T10:00:00+00:00",
      "end": "2026-06-16T06:00:00+00:00",
      "status": "booked",
      "created": "2026-01-20T08:00:00+00:00",
      "updated": "2026-01-21T09:00:00+00:00"
    }
  ],
  "metadata": {
    "next_page": null,
    "total_results": 1
  }
}

Taxi reservation details (3.2)

Scenario: Retrieve taxi order details including multiple legs (two different reservation IDs).

{
  "request_id": "03fr9fz702lmnop12w34x5y6z",
  "data": [
    {
      "id": "709430129718801",
      "affiliate": 333333,
      "taxis": [
        {
          "reservation": "TX987654321",
          "pickup_location": { "city": "Paris", "country": "fr" },
          "dropoff_location": { "city": "Lyon", "country": "fr" },
          "start": "2026-07-10T09:00:00+00:00",
          "end": "2026-07-10T14:00:00+00:00"
        },
        {
          "reservation": "TX987654322",
          "pickup_location": { "city": "Lyon", "country": "fr" },
          "dropoff_location": { "city": "Marseille", "country": "fr" },
          "start": "2026-07-12T10:00:00+00:00",
          "end": "2026-07-12T15:00:00+00:00"
        }
      ],
      "booker": {
        "name": { "first_name": "Bob", "last_name": "Brown" },
        "email": "bob.brown@example.com",
        "telephone": "+33123456789",
        "language": "fr",
        "platform": "mobile",
        "travel_purpose": "leisure",
        "address": { "city": "Paris", "country": "fr" }
      },
      "commission": {
        "actual_commission_amount": { "booker_currency": 30.0, "product_currency": 32.0 },
        "actual_percentage": 8.0,
        "estimated_commission_amount": { "booker_currency": null, "product_currency": null }
      },
      "currencies": { "booker": "EUR", "product": "EUR" },
      "price": {
        "commissionable_price": { "booker_currency": 375, "product_currency": 400 },
        "total_price": { "booker_currency": 400, "product_currency": 425 }
      },
      "start": "2026-07-10T09:00:00+00:00",
      "end": "2026-07-12T15:00:00+00:00",
      "status": "booked",
      "created": "2026-02-01T08:00:00+00:00",
      "updated": "2026-02-02T10:00:00+00:00"
    }
  ],
  "metadata": {
    "next_page": null,
    "total_results": 1
  }
}

Post-booking - Specific travel service details

Use each orders/details/*service endpoint for granulated details on a specific travel service so you can perform post-booking tasks such as:

Guides

orders/details/accommodation

Learn how to use this endpoint to retrieve all the details of an accommodation reservation for post-booking flows.

orders/details/cars

Follow this guide to retrieve all the details of a car rental reservation for post-booking tasks.

orders/details/flights

Check how to use this endpoint to retrieve all the details of a flight reservation for post-booking flows.

Curious to know more?