> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.navipartner.com/apis/api-reference/ota-channel-manager/service-order/list-orders-by-partner/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.navipartner.com/_mcp/server. # List Orders by Partner GET https://api.npretail.app/{tenant}/{environment}/{company}/channelManager/orders/{partnerId} List orders that belong to a specific partner. Filters are AND-combined and applied as exact matches except where noted: - `status` — comma-separated list of `OrderStatus` values; matches any of them. Useful for tracking in-flight orders with `status=Submitted,Scheduled,Processing`. - `sellToOrderReference` — exact match on the partner's order reference. - `receivedAtFrom` / `receivedAtTo` — inclusive ISO 8601 bounds. Either bound may be supplied independently. Results are paginated according to the standard pagination conventions; see [Pagination](/pagination) for details. The returned objects are the compact `OrderSummary` shape — to inspect issued wallets, follow up with `getOrder`. Reference: https://docs.navipartner.com/apis/api-reference/ota-channel-manager/service-order/list-orders-by-partner ## Authentication - `x-np-api-key` header (required) — API Key authentication via header ## Request ### 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) - `partnerId` (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. ### Query parameters - `status` (string, optional) — Filter `listOrdersByPartner` by one or more `status` values. Multiple statuses are comma-separated (e.g. `Submitted,Scheduled,Processing`). - `sellToOrderReference` (string, optional) — The partner's own reference for the order. Unique per partner; combined with `partnerId` it identifies the order end-to-end. Maximum 50 characters. - `receivedAtFrom` (datetime, optional) — Inclusive lower bound for filtering `listOrdersByPartner` by `receivedAt`. ISO 8601. - `receivedAtTo` (datetime, optional) — Inclusive upper bound for filtering `listOrdersByPartner` by `receivedAt`. ISO 8601. ## Response ### 200 - `list of OrderSummary` ## Types ### OrderSummary Compact representation of an order, returned by `listOrdersByPartner`. Items and wallets are not included; fetch a specific order with `getOrder` for the full representation. - `orderId` (UUID, required) — Globally unique identifier of an OTA Channel Manager order, assigned when the order is accepted. - `partnerId` (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. - `status` (enum, required) — Lifecycle state of an OTA Channel Manager order. The terminal states are `Issued`, `Draft`, `Cancelled`, and `Error`. The non-terminal states (`Submitted`, `Scheduled`, `Processing`) belong to the asynchronous issuance pipeline: - `Submitted` — async order is queued for background processing. - `Scheduled` — order has been picked up for processing. - `Processing` — ticket and coupon issuance is running. - `Draft` — assets are issued but no `paymentReference` was supplied. Call `confirmOrder` to release the order to `Issued`. - `Issued` — all assets have been issued, coupons have been posted, and the wallet manifest is available at `manifestUrl`. - `Cancelled` — order has been cancelled. Wallets are destroyed but the order row is retained for audit. - `Error` — issuance failed. Inspect `statusMessage` for details. The order can be replaced (`replaceOrder`) to retry, or deleted (`deleteOrder`) to remove it. - Allowed values: `Submitted`, `Scheduled`, `Processing`, `Draft`, `Issued`, `Cancelled`, `Error` - `statusMessage` (string, required) — Human-readable detail about the current `status`, set by the OTA Channel Manager. Populated for `Error`; empty otherwise. - `receivedAt` (datetime, required) — UTC timestamp recorded when the OTA Channel Manager accepted the order. ISO 8601. - `sellToEmail` (string, optional) — 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, optional) — Name of the customer the order is sold to. Maximum 100 characters. Can be overridden per item. - `sellToLanguage` (string, optional) — 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, optional) — 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. - `jobId` (string, optional) — 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, optional) — URL of the printable wallet manifest, populated once asset issuance has completed. ## Examples **Response** ```json [ { "orderId": "9c6b2f4e-2b71-4d23-9d6a-a3b4c5d6e7f8", "partnerId": "21e8c1d2-3f4a-4c5b-9e6d-7f8a9b0c1d2e", "sellToOrderReference": "PARTNER-ORDER-2026-00042", "buyFromOrderReference": "CM-20260515093000-A1B2", "status": "Issued", "statusMessage": "", "receivedAt": "2026-05-15T09:30:00Z", "sellToEmail": "guest@example.com", "sellToName": "Jane Doe", "sellToLanguage": "ENU", "paymentReference": "PAY-987654", "jobId": "TM-IMPORT-000123", "manifestUrl": "https://manifests.npretail.app/wallets/manifest?mid=9c6b2f4e-2b71-4d23-9d6a-a3b4c5d6e7f8" } ] ``` **SDK Code** ```python List issued orders received in May import requests url = "https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./channelManager/orders/21e8c1d2-3f4a-4c5b-9e6d-7f8a9b0c1d2e" querystring = {"status":"Issued","receivedAtFrom":"2026-05-01T00:00:00Z","receivedAtTo":"2026-05-31T23:59:59Z"} headers = {"x-np-api-key": ""} response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ```javascript List issued orders received in May const url = 'https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./channelManager/orders/21e8c1d2-3f4a-4c5b-9e6d-7f8a9b0c1d2e?status=Issued&receivedAtFrom=2026-05-01T00%3A00%3A00Z&receivedAtTo=2026-05-31T23%3A59%3A59Z'; const options = {method: 'GET', headers: {'x-np-api-key': ''}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go List issued orders received in May package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./channelManager/orders/21e8c1d2-3f4a-4c5b-9e6d-7f8a9b0c1d2e?status=Issued&receivedAtFrom=2026-05-01T00%3A00%3A00Z&receivedAtTo=2026-05-31T23%3A59%3A59Z" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("x-np-api-key", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby List issued orders received in May require 'uri' require 'net/http' url = URI("https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./channelManager/orders/21e8c1d2-3f4a-4c5b-9e6d-7f8a9b0c1d2e?status=Issued&receivedAtFrom=2026-05-01T00%3A00%3A00Z&receivedAtTo=2026-05-31T23%3A59%3A59Z") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["x-np-api-key"] = '' response = http.request(request) puts response.read_body ``` ```java List issued orders received in May import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./channelManager/orders/21e8c1d2-3f4a-4c5b-9e6d-7f8a9b0c1d2e?status=Issued&receivedAtFrom=2026-05-01T00%3A00%3A00Z&receivedAtTo=2026-05-31T23%3A59%3A59Z") .header("x-np-api-key", "") .asString(); ``` ```php List issued orders received in May request('GET', 'https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./channelManager/orders/21e8c1d2-3f4a-4c5b-9e6d-7f8a9b0c1d2e?status=Issued&receivedAtFrom=2026-05-01T00%3A00%3A00Z&receivedAtTo=2026-05-31T23%3A59%3A59Z', [ 'headers' => [ 'x-np-api-key' => '', ], ]); echo $response->getBody(); ``` ```csharp List issued orders received in May using RestSharp; var client = new RestClient("https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./channelManager/orders/21e8c1d2-3f4a-4c5b-9e6d-7f8a9b0c1d2e?status=Issued&receivedAtFrom=2026-05-01T00%3A00%3A00Z&receivedAtTo=2026-05-31T23%3A59%3A59Z"); var request = new RestRequest(Method.GET); request.AddHeader("x-np-api-key", ""); IRestResponse response = client.Execute(request); ``` ```swift List issued orders received in May import Foundation let headers = ["x-np-api-key": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./channelManager/orders/21e8c1d2-3f4a-4c5b-9e6d-7f8a9b0c1d2e?status=Issued&receivedAtFrom=2026-05-01T00%3A00%3A00Z&receivedAtTo=2026-05-31T23%3A59%3A59Z")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` > Documentation for NaviPartner's NP Retail, NP Attractions, NP Hospitality, NP Store Assistant and Entria products, plus their REST APIs, built on Microsoft Dynamics 365 Business Central.