Marketplace
Read-only, account-wide view of the webshops and marketplaces orders are imported from. Lists the account's connectors and their IDs, and lists imported orders across ALL of them with the sales receipts, invoices and AWBs generated for each. Use this instead of the per-connector order list when you want one feed of every order regardless of its source.
Returns the order connectors configured on the account — the webshops and marketplaces orders are imported from — together with their BOCP IDs.
Call this first. connector_id is the value the /marketplace/orders/list/ filter expects, and there is no other way to discover it: the per-connector routes require you to already know the ID.
Inactive and deleted connectors are returned too, flagged by active and deleted, because historical orders still point at them. Pass skipcancelled to omit the deleted ones.
Supported filters: id, minid, skipcancelled, page. Connectors are returned oldest ID first. Date filters do not apply to this endpoint and return 400.
Note for connector-bound API keys: a key issued for one specific connector only ever sees that one connector in this list.
Credentials and internal endpoints configured on a connector (usernames, API URLs, push URLs, secrets) are deliberately not returned.
Responses
| Status | Description |
|---|---|
200 |
The account's order connectors. |
400 |
Request is malformed or a required field is missing / invalid. |
401 |
Missing or invalid Basic Auth credentials. |
404 |
No connectors matched — the account has none configured, or the filters excluded them all. |
Returns a paginated, account-wide list of imported webshop / marketplace orders, together with the sales receipts, fiscal invoices and AWBs generated for each one.
This is the global counterpart of GET /connector/{connector_id}/order/list/: same item shape, but it is not bound to a single connector, and each item carries a connector block telling you where the order came from.
Filters are passed as URL path segments. Example: /marketplace/orders/list/connector_id:7/datefrom:2026-08-01/datethrough:2026-08-31/page:2/.
Supported filters:
- connector_id — only orders imported through this connector. Get the IDs from GET /marketplace/connectors/list/.
- datefrom / datethrough — order-date period, YYYY-MM-DD, both inclusive.
- year — a whole year, e.g. year:2026.
- yearmonth — a whole month, e.g. yearmonth:202608.
- date — a single day, e.g. date:2026-08-14.
- modifiedafter / modifiedthrough — filter on the last-change timestamp, YYYY-MM-DD HH:MM:SS. Use modifiedafter for incremental syncs.
- skipcancelled — omit deleted orders.
Cancelled sale receipts and cancelled AWBs are returned too, each flagged by its own cancelled field, so you can show that a shipment or receipt is no longer valid instead of it silently disappearing from your copy of the data.
- id — a single BOCP order ID.
- minid — orders from this BOCP order ID upwards.
- page — page number, 250 items per page.
Orders are returned newest first (rec_id descending). data_next_page_exists in the envelope tells you whether to request the next page, and data_next_page_url is the ready-made URL for it. A page with no matching orders returns 404, not an empty 200.
Note for connector-bound API keys: a key issued for one specific connector is silently restricted to that connector's orders, and passing a different connector_id returns 401.
Responses
| Status | Description |
|---|---|
200 |
Paginated list of orders. Each item includes its connector, linked sales receipts, invoices, and AWBs. |
400 |
Request is malformed or a required field is missing / invalid. |
401 |
Missing or invalid Basic Auth credentials. |
404 |
The requested resource does not exist. |
This page is generated from openapi.json.