# 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.*



```json
{
  "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.*



```json
{
    "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](/assets/genius-bulb.3e13976eeeabd0526f1d76bfb7de5967932211a5ef4afe526a3b0a71a7b02fb0.5e2a7131.png) 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.*



```json
{
  "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*.


v3.1 response

```json
{
  "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"
}
```

v3.2 response

```json
{
  "request_id": "01fr9ez700exycb98w90w5r9sh",
  "data": [
    {
      "id": "509430129718799",
      "accommodations": {
        "inventory": {
          "third_party": false,
          "type": "sell"
        },
        "location": {
          "address": "111 Street Road",
          "city": 20089219,
          "country": "us"
        },
        "name": "Test Booking Hotel USA",
        "number_of_guests": 2,
        "reservation": 12345677,
        "stay_probability": 0.12
      },
      "affiliate": 111111,
      "booker": {...},
      "commission": {
        "actual_amount": 17.5, // Deprecated
        "actual_commission_amount": {
          "booker_currency": 17.5,
          "product_currency": 20.6
        },
        "actual_percentage": null,
        "estimated_amount": null, // Deprecated
        "estimated_commission_amount": {
          "booker_currency": null,
          "product_currency": null
        }
      },
      "created": "2025-11-28T02:00:00+00:00",
      "currencies": {
        "booker_currency": "EUR",
        "product_currency": "USD"
      },
      "currency": "EUR",
      "end": "2026-03-28T02:00:00+00:00",
      "flights": null,
      "label": "One123",
      "loyalty_reward": [
        {
          "amount": 150,
          "currency": "USD",
          "eligible": true,
          "fulfillment_at": "2025-12-15",
          "fulfillment_by": "partner",
          "loyalty_data": [
            { "name": "Email Id", "value": "jane.doe@example.com" },
            { "name": "Loyalty ID", "value": "LD123456" }
          ],
          "type": "point"
        }
      ],
      "payment": {
        "method": "card",
        "timing": "pay_online_now",
        "paid": [
          {
            "amount": 170.01,
            "at": "2025-11-28T02:00:00+00:00",
            "transaction_currency": "EUR"
          }
        ],
        "pending": [],
        "accommodations": {
          "reservation": 12345677,
          "authorisation_form": "https://secure-admin.booking.com/airplus_auth_form_pdf.html?token=AAAA&lang=en-us",
          "receipt_url": "https://secure.booking.com/payment_receipt.html?bn=0000000000&pincode=0000&lang=en"
        }
      },
      "price": {
        "commissionable": 160, // Deprecated
        "commissionable_price": {
          "booker_currency": 160,
          "product_currency": 188.32
        },
        "total_price": {
          "booker_currency": 170.01,
          "product_currency": 200.1
        },
        "commissionable": null,
        "total": null
      }
    }
  ],
  "metadata": {
    "next_page": null,
    "total_results": 1
  }
}
```

Note: As this order was **cancelled by the guest**, commission is 0. See the [cancellation guide](/demand/docs/orders-api/cancel-order#3.-review-and-confirm-in-order-details) for details.

### Cancelled orders

A standard response for a cancelled order would be:

v3.1 response

```json

{
     "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"
},
```

v3.2 response

```json
{
  "order_id": "509430129718799",
  "accommodations": {
    "reservation": 12345677,
    "name": "Test Booking Hotel USA",
    "location": {"address": "111 Street Road", "city": 20089219, "country": "us"},
    "number_of_guests": 2,
    "inventory": {"third_party": false, "type": "sell"},
    "stay_probability": 0.12
  },
  "affiliate": 111111,
  "booker": {...},
  "commission": {
    "actual_commission_amount": {"booker_currency": 0.0, "product_currency": 0.0}
  },
  "currencies": {"booker": "EUR", "product": "USD"},
  "price": {
    "commissionable_price": {"booker_currency": 0.0, "product_currency": 0.0},
    "total_price": {"booker_currency": 0.0, "product_currency": 0.0}
  },
  "status": "cancelled_by_guest",
  "start": "2026-03-21T02:00:00+00:00",
  "end": "2026-03-28T02:00:00+00:00",
  "created": "2025-11-28T02:00:00+00:00",
  "updated": "2025-11-28T02:00:00+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*.



```json
 {
  "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


```json
{
  "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

v3.1 response

```json
{
  "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"
    }
  ],
}
```

v3.2 response

```json
{
  "request_id": "01fr9ez700exycb98w90w5r9sh",
  "data": [
    {
      "id": "509430129718799",
      "affiliate": 111111,
      "accommodations": null,
      "cars": {
        "reservation": 9876543,
        "pickup_location": {
          "city": "Amsterdam",
          "country": "nl"
        },
        "dropoff_location": {
          "city": "Rotterdam",
          "country": "nl"
        }
      },
      "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": null, // Deprecated
        "actual_commission_amount": {
          "booker_currency": 17.5,
          "product_currency": 20.6
        },
        "actual_percentage": null, // Deprecated
        "estimated_amount": null,
        "estimated_commission_amount": {
          "booker_currency": null,
          "product_currency": null
        }
      },
      "currencies": {
        "booker_currency": "EUR",
        "product_currency": "USD"
      },
      "currency": "EUR",
      "start": "2026-03-21T02:00:00+00:00",
      "end": "2026-03-28T02:00:00+00:00",
      "flights": null,
      "label": "One123",
      "loyalty_reward": [...],
      "price": {
        "commissionable": 160, // Deprecated
        "commissionable_price": {
          "booker_currency": 160,
          "product_currency": 188.32
        },
        "total": 170.01,
        "total_price": {
          "booker_currency": 170.01,
          "product_currency": 200.1
        }
      },
      "status": "booked",
      "updated": "2025-11-28T02:00:00+00:00",
      "created": "2025-11-28T02:00:00+00:00",
      "payment": {
        "method": "card",
        "timing": "pay_online_now",
        "paid": [
          {
            "amount": 170.01,
            "at": "2025-11-28T02:15:00+00:00",
            "transaction_currency": "EUR"
          }
        ],
        "pending": null,
        "accommodations": null
      }
    }
  ],
  "metadata": {
    "next_page": null,
    "total_results": 1
  }
}
```

### Attraction reservation details (v3.2)


```json
{
  "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.



```json
{
  "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).



```json
{
  "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:

* Managing [cancellations](/demand/docs/orders-api/cancel-order) or [modifications](/demand/docs/open-api/demand-api/orders/orders/modify).
* Reporting commissions to affiliates.
* Allocating loyalty points or rewards.


### Guides

Curious to know more?
* [Run order reports guide](/demand/docs/orders-api/order-details)
* Orders — [Labels and attribution guide](/demand/docs/orders-api/labels-attributions).
* See the [Pagination guide](/demand/docs/development-guide/pagination) for best practices handling large results sets.
* Demand API [v3.2 Orders migration guide](/demand/docs/migration-guide/v3.2/orders/details)