---
title: "Orders details"
method: POST
path: "/orders/details"
tags: ["Orders"]
---

# Orders details

`POST /orders/details`

This endpoint returns basic information for orders filtered according to the input.

## Headers

- `X-Affiliate-Id` integer, required

## Request body

- union
  - object
    - `updated` object, required — Filtering orders by time range on basis of order "created" or "updated" time. Maximum time range is 7 days (1 week).
      - `from` string, date-time, required — ISO 8601 timestamp in UTC, which indicates the timestamp from which you want to filter orders from (inclusive). The value should be within last 1 year.
      - `to` string, date-time — ISO 8601 timestamp in UTC, which indicates the timestamp till which you want to filter orders to (inclusive). It has to be greater than or equal to "from".
    - `currency` string, required — A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard. The full list can be obtained by calling <a href="/demand/docs/open-api/demand-api/commonpayments/common/payments/currencies" target="_blank">common/payments/currencies</a>.
    - `maximum_results` integer — The maximum number of results to return.
    - `sort` object — The sorting parameters for the response.
      - `by` 'created' | 'updated', required — The way to sort your results.
      - `direction` 'ascending' | 'descending', required — The direction you wish for your sort.by parameter to be sorted in.
    - `extras` string[] — Input parameter to request for additional information about this order.
    - `services` string[] — Filter orders by included services.
  - object
    - `created` object, required — Filtering orders by time range on basis of order "created" or "updated" time. Maximum time range is 7 days (1 week).
      - `from` string, date-time, required — ISO 8601 timestamp in UTC, which indicates the timestamp from which you want to filter orders from (inclusive). The value should be within last 1 year.
      - `to` string, date-time — ISO 8601 timestamp in UTC, which indicates the timestamp till which you want to filter orders to (inclusive). It has to be greater than or equal to "from".
    - `currency` string, required — A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard. The full list can be obtained by calling <a href="/demand/docs/open-api/demand-api/commonpayments/common/payments/currencies" target="_blank">common/payments/currencies</a>.
    - `maximum_results` integer — The maximum number of results to return.
    - `sort` object — The sorting parameters for the response.
      - `by` 'created' | 'updated', required — The way to sort your results.
      - `direction` 'ascending' | 'descending', required — The direction you wish for your sort.by parameter to be sorted in.
    - `extras` string[] — Input parameter to request for additional information about this order.
    - `services` string[] — Filter orders by included services.
  - object
    - `start` object, required — Filter orders by date range, covering the "start" and "end" date. The maximum date range is up to 7 days (1 week).
      - `from` string, date, required — ISO 8601 date in "YYYY-MM-DD" format. It indicates from which date you want to filter the orders. You can filter orders up to 1 year in the past and 500 days in the future.
      - `to` string, date — ISO 8601 date in "YYYY-MM-DD" format. It indicates until which date you want to filter the orders to (inclusive). It has to be greater than or equal to "from". It uses "from" value as default.
    - `currency` string, required — A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard. The full list can be obtained by calling <a href="/demand/docs/open-api/demand-api/commonpayments/common/payments/currencies" target="_blank">common/payments/currencies</a>.
    - `maximum_results` integer — The maximum number of results to return.
    - `sort` object — The sorting parameters for the response.
      - `by` 'created' | 'updated', required — The way to sort your results.
      - `direction` 'ascending' | 'descending', required — The direction you wish for your sort.by parameter to be sorted in.
    - `extras` string[] — Input parameter to request for additional information about this order.
    - `services` string[] — Filter orders by included services.
  - object
    - `end` object, required — Filter orders by date range, covering the "start" and "end" date. The maximum date range is up to 7 days (1 week).
      - `from` string, date, required — ISO 8601 date in "YYYY-MM-DD" format. It indicates from which date you want to filter the orders. You can filter orders up to 1 year in the past and 500 days in the future.
      - `to` string, date — ISO 8601 date in "YYYY-MM-DD" format. It indicates until which date you want to filter the orders to (inclusive). It has to be greater than or equal to "from". It uses "from" value as default.
    - `currency` string, required — A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard. The full list can be obtained by calling <a href="/demand/docs/open-api/demand-api/commonpayments/common/payments/currencies" target="_blank">common/payments/currencies</a>.
    - `maximum_results` integer — The maximum number of results to return.
    - `sort` object — The sorting parameters for the response.
      - `by` 'created' | 'updated', required — The way to sort your results.
      - `direction` 'ascending' | 'descending', required — The direction you wish for your sort.by parameter to be sorted in.
    - `extras` string[] — Input parameter to request for additional information about this order.
    - `services` string[] — Filter orders by included services.
  - object
    - `currency` string, required — A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard. The full list can be obtained by calling <a href="/demand/docs/open-api/demand-api/commonpayments/common/payments/currencies" target="_blank">common/payments/currencies</a>.
    - `orders` string[], required — List of order IDs for which details should be returned.
    - `sort` object — The sorting parameters for the response.
      - `by` 'created' | 'updated', required — The way to sort your results.
      - `direction` 'ascending' | 'descending', required — The direction you wish for your sort.by parameter to be sorted in.
    - `extras` string[] — Input parameter to request for additional information about this order.
    - `services` string[] — Filter orders by included services.
  - object
    - `currency` string, required — A three-letter code that uniquely identifies a monetary currency as defined by the ISO 4217 standard. The full list can be obtained by calling <a href="/demand/docs/open-api/demand-api/commonpayments/common/payments/currencies" target="_blank">common/payments/currencies</a>.
    - `reservations` string[], required — List of reservation IDs for which details should be returned.
    - `sort` object — The sorting parameters for the response.
      - `by` 'created' | 'updated', required — The way to sort your results.
      - `direction` 'ascending' | 'descending', required — The direction you wish for your sort.by parameter to be sorted in.
    - `extras` string[] — Input parameter to request for additional information about this order.
    - `services` string[] — Filter orders by included services.
  - object
    - `page` string, required — Pagination token used to retrieve the next page of results. Obtained from `next_page`.
    - `extras` string[] — Input parameter to request for additional information about this order.

## Response `200`

Successful response.

- object
  - `data` object[]
    - `id` string — The id for this order.
    - `accommodations` object
      - `inventory` object
        - `third_party` boolean — Boolean value is "true" if the product is facilitated by a Booking.com partner company and "false" otherwise.
        - `type` 'net' | 'sell' — Type of inventory - either net or sell rates.
      - `reservation` integer — This is the reservation id for the accommodation in this order.
    - `affiliate` integer — The affiliate id used for this order.
    - `booker` object — The booker's information.
      - `address` object — The booker's address for showing the best price for that user and obeying laws regarding the display of taxes and fees.
        - `city` string, nullable — The city for this address.
        - `country` string, nullable — The country for this address.
      - `email` string, nullable — The booker's email address.
      - `language` string — A [IETF language tag code](https://en.wikipedia.org/wiki/IETF_language_tag) that uniquely identifies a supported human language or dialect. **Note:** Demand API only accepts lowercase for the language codes. Examples: "nl" for Dutch/Nederlands or "en-us" for English (US). To retrieve the full list of supported languages, call the `/common/languages` endpoint in the same Demand API version you are using.
      - `name` object — The name of the booker.
        - `first_name` string, nullable
        - `last_name` string, nullable
      - `platform` 'app' | 'desktop' | 'mobile_browser' | 'tablet' | 'unknown' — The booker platform for showing the platform based deals and prices.
      - `telephone` string, nullable — The booker's telephone number.
      - `travel_purpose` 'business' | 'leisure' | 'unknown' — The travel purpose of the booker.
    - `cars` object
      - `reservation` integer — This is the reservation id for the car in this order.
    - `created` string, date-time — Order creation time.
    - `commission` object — Commission details for the partner for a given order.
      - `actual_amount` number, double, nullable — For accommodation: This is the final commission for this order (`null` if value is not yet available). For other travel services: It represents the estimated commission before billing and the final commission after billing.
      - `estimated_amount` number, double, nullable — Estimated commission amount for this order. For accommodations, it will be `null` if the final commission amount is available.
    - `currency` string — Input currency used in "commission" and "price" output fields.
    - `flights` object
      - `reservation` integer — This is the reservation id for flight in this order.
    - `loyalty_reward` object[], nullable — Details of the loyalty rewards associated with this order.
      - `amount` number, double — Reward amount, in the units of the specified reward type (such as cash, mile, point, etc.).
      - `currency` string, nullable — Currency used for reward calculation.
      - `eligible` boolean — Whether the order is eligible for the reward.
      - `fulfillment_at` string, date — Date and time at which the reward should be fulfilled.
      - `fulfillment_by` 'partner' | 'booking.com' — Mode of fulfillment of the reward.
      - `loyalty_data` object[], nullable — Loyalty data associated with this loyalty reward used to fulfill reward.
        - `name` string — Name of the loyalty data.
        - `value` string — Value of the loyalty data.
      - `type` 'cash' | 'mile' | 'point' | 'voucher' | 'voucher_money' | 'voucher_subscription' | 'voucher_percentage' — Type of reward.
    - `payment` object — The payment details of this order.
      - `accommodations` object, nullable — The accommodation specific payment details of this order.
        - `authorisation_form` string, uri, nullable — Link to the authorisation form of the order.
        - `receipt_url` string, uri, nullable — Link to the payment receipt of the order. `This will only be added if the payment is already charged.`
        - `reservation` integer — Reservation ID for this accommodation order.
      - `method` 'airplus' | 'card' | 'wallet' — The payment method of this order.
      - `paid` object[], nullable — The paid transactions for this order.
        - `amount` number — Amount of the transaction.
        - `at` string, date-time — Time of the transaction.
        - `transaction_currency` string — Currency in which the transaction took place.
      - `pending` object[], nullable — The pending transactions for this order.
        - `amount` number — Amount of the transaction.
        - `at` string, date-time — Time of the transaction.
        - `transaction_currency` string — Currency in which the transaction took place.
      - `timing` 'pay_at_the_property' | 'pay_online_later' | 'pay_online_now' — The payment timing of this order.
    - `price` object, nullable — The price components of this order.
      - `commissionable` number, double, nullable — The commissionable price. Order price on which commission amount is calculated.
      - `total` number, double — The total price. Includes all extra charges.
    - `status` 'booked' | 'cancelled' | 'cancelled_by_accommodation' | 'cancelled_by_guest' | 'no_show' | 'stayed' — Status of this order.
    - `updated` string, date-time — Time the order was last updated.
  - `metadata` object — Metadata about the request.
    - `next_page` string, nullable — Indicates that more results are available. Use this pagination token to retrieve the next page of results (via parameter `page`).
    - `total_results` integer — The total number of results available.
  - `request_id` string — Uniquely identifies the request. Please provide this identifier when contacting support.

---

[API](https://skmtc.net/booking/apis/booking-com-demand-api.md) · [All operations](https://skmtc.net/booking/apis/booking-com-demand-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/booking/booking-com-demand-api/revisions/e5f3dccae7ca/schema)