---
title: "Get Order"
method: GET
path: "/{tenant}/{environment}/{company}/channelManager/{orderId}"
tags: ["channelManager > Orders"]
---

# Get Order

`GET /{tenant}/{environment}/{company}/channelManager/{orderId}`

Retrieve the full representation of an OTA Channel Manager order, including its issued wallets and
ticket/coupon assets.

This is the polling endpoint for async-submitted orders: after `createOrder` or `replaceOrder`
returns `Submitted`, call `getOrder` periodically until `status` is one of `Issued`, `Draft`,
or `Error`. (Or skip polling entirely by subscribing to the `ota_cm_order_processed` webhook.)

## Path parameters

- `tenant` string, required — Your Entra Tenant ID. [More details.](/paths#1-tenant)
- `environment` string, required — Your Business Central Environment. [More details.](/paths#2-environment)
- `company` string, required — Your Business Central Company. [More details.](/paths#3-company)
- `orderId` string, uuid, required — Globally unique identifier of an OTA Channel Manager order, assigned when the order is accepted.

## Headers

- `x-api-version` string, date — Used for API versioning. [More details.](/apis/versioning)

## Response `200`

Response with status 200

- ChannelManagerTypesCompositeOrderResponse — Full representation of an OTA Channel Manager order, including the issued wallets and their assets. `createOrder` and `replaceOrder` return the order with `status = Submitted` by default (async mode); with `?sync=true` they return the final state directly. `confirmOrder` and `getOrder` always return the order in its current state.
  - `orderId` string, uuid, required — Globally unique identifier of an OTA Channel Manager order, assigned when the order is accepted.
  - `status` 'Submitted' | 'Scheduled' | 'Processing' | 'Draft' | 'Issued' | 'Cancelled' | 'Error', required
  - `statusMessage` string, required — Human-readable detail about the current `status`, set by the OTA Channel Manager. Populated for `Error`; empty otherwise.
  - `partnerId` string, uuid, required — Globally unique identifier of the OTA Channel Manager partner that originated the order. The partner must exist and be active in the OTA Channel Manager Partner Setup; otherwise the order is rejected.
  - `sellToOrderReference` string, required — The partner's own reference for the order. Unique per partner; combined with `partnerId` it identifies the order end-to-end. Maximum 50 characters.
  - `buyFromOrderReference` string, required — The OTA Channel Manager's own document number for the order, used as a stable identifier for partner-side reconciliation. Maximum 20 characters.
  - `sellToEmail` string — Email address of the customer the order is sold to. Stored on the order and on each issued wallet for the partner's own use; the OTA Channel Manager does not send anything to this address. Maximum 100 characters. Can be overridden per item.
  - `sellToName` string — Name of the customer the order is sold to. Maximum 100 characters. Can be overridden per item.
  - `sellToLanguage` string — Language code (uppercased) for the customer the order is sold to. Used to localize the `description` fields on items and assets via Item Translation. Must be a valid Business Central language code. Maximum 10 characters. Can be overridden per item.
  - `paymentReference` string — Reference to the partner-side payment transaction. May be supplied at order creation, or later via `confirmOrder`. Required to move an order from Draft to Issued. Maximum 50 characters.
  - `receivedAt` string, date-time, required — UTC timestamp recorded when the OTA Channel Manager accepted the order. ISO 8601.
  - `jobId` string — Background job identifier assigned by the OTA Channel Manager when ticket issuance has been performed for an order. Empty until issuance has begun.
  - `manifestUrl` string — URL of the printable wallet manifest, populated once asset issuance has completed.
  - `items` ChannelManagerTypesCompositeOrderItemResponse[], required
    - `lineNo` integer, required — Server-assigned ordinal of a line within the order, incrementing by 100000. Echoed back in responses for diagnostics; partners do not supply it on input.
    - `itemNumber` string, required — Business Central item number that identifies the product being sold. Must exist as an Item record. A package item (one with an Item Add-On) expands into multiple component admissions, optionally with coupons; a non-package item is a single ticket item.
    - `description` string, required — Item description, translated to the line's `sellToLanguage` via Item Translation when available; otherwise the default item description. Returned by the server.
    - `isPackage` boolean, required — `true` if the line item is configured with an Item Add-On (i.e., a package item with multiple components). Returned by the server; not supplied on input.
    - `quantity` integer, required — Number of admissions to issue for this line. Must be `>= 1`. For a group ticket, the quantity is the group size and a single wallet is issued. For an individual ticket, each unit is issued as its own wallet.
    - `visitDate` string, date, required — Date of the visit. Format `YYYY-MM-DD`. Must not be in the past relative to the local time at the admission.
    - `visitTime` string, required — Time of the visit on `visitDate`. Format `HH:mm:ss` (24-hour, local park time).
    - `sellToName` string — Name of the customer the order is sold to. Maximum 100 characters. Can be overridden per item.
    - `sellToEmail` string — Email address of the customer the order is sold to. Stored on the order and on each issued wallet for the partner's own use; the OTA Channel Manager does not send anything to this address. Maximum 100 characters. Can be overridden per item.
    - `sellToLanguage` string — Language code (uppercased) for the customer the order is sold to. Used to localize the `description` fields on items and assets via Item Translation. Must be a valid Business Central language code. Maximum 10 characters. Can be overridden per item.
    - `componentSchedule` ChannelManagerTypesCompositeComponentScheduleEntryResponse[]
      - `itemNumber` string, required — Business Central item number that identifies the product being sold. Must exist as an Item record. A package item (one with an Item Add-On) expands into multiple component admissions, optionally with coupons; a non-package item is a single ticket item.
      - `visitDate` string, date, required — Date of the visit. Format `YYYY-MM-DD`. Must not be in the past relative to the local time at the admission.
      - `visitTime` string, required — Time of the visit on `visitDate`. Format `HH:mm:ss` (24-hour, local park time).
    - `wallets` ChannelManagerTypesCompositeWalletResponse[], required
      - `seqNo` integer, required — Sequence number of a wallet inside its order line, starting at 1. For individual tickets, the number of wallets equals the line's `quantity`; for group tickets it is always 1.
      - `walletId` string, uuid — Globally unique identifier of the issued wallet. Populated once assets have been issued.
      - `walletReferenceNumber` string — The visual reference number of the issued wallet.
      - `externalReferenceNumber` string — Optional partner-side reference number written onto an issued wallet. When supplying `wallet.externalReferenceNumbers`, the array length must match the line's expected wallet count.
      - `name` string — Optional human-readable label for an issued wallet (e.g. the holder's name). When supplying `wallet.names`, the array length must match the line's expected wallet count.
      - `issuedAt` string, date-time — UTC timestamp when the wallet was issued. ISO 8601.
      - `unitPriceExclVat` number, double — Unit price of the wallet, excluding VAT, in `currencyCode`.
      - `unitPriceInclVat` number, double — Unit price of the wallet, including VAT, in `currencyCode`.
      - `currencyCode` string — ISO 4217 currency code of the issued wallet.
      - `manifestUrl` string — URL of the printable wallet manifest, populated once asset issuance has completed.
      - `assets` ChannelManagerTypesCompositeAssetResponse[], required
        - `id` string, uuid, required — Identifier of the asset line within the wallet — independent of the asset type.
        - `type` 'ticket' | 'coupon', required
        - `assetId` string, uuid, required — Globally unique identifier of an asset (ticket or coupon) inside a wallet.
        - `referenceNumber` string, required — External reference number printed on the asset — the external ticket number for tickets, or the coupon reference number for coupons.
        - `itemNumber` string, required — Business Central item number that identifies the product being sold. Must exist as an Item record. A package item (one with an Item Add-On) expands into multiple component admissions, optionally with coupons; a non-package item is a single ticket item.
        - `description` string, required — Item description, translated to the line's `sellToLanguage` via Item Translation when available; otherwise the default item description. Returned by the server.

## Changes

- **2026-09-17** `48cacf22ffcd` — 1 breaking, 1 warning, 16 info
  - the response's body type changed from no type to `object` for status `200`
  - deleted the `header` request parameter `x-np-api-key`
  - the endpoint scheme security `NPApiKeyAuthScheme` was added to the API
  - for the `path` request parameter `orderId`, the type was generalized from no type to `string`, and format from no format to `uuid`
  - …14 more
- **2026-09-12** `407697660280` — 1 info
  - api operation id `get-order` removed and replaced with `channelManager_serviceOrder_getOrder`

[Change history](https://skmtc.dev/navipartner/apis/api-reference/changes/:tenant/:environment/:company/channelManager/:orderId/get.md)

---

[API](https://skmtc.dev/navipartner/apis/api-reference.md) · [All operations](https://skmtc.dev/navipartner/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/navipartner/apis/api-reference/revisions/48cacf22ffcd?raw)