Orders API

MarketplaceHub has an Orders API for pulling orders and pushing confirmations, cancellations and refunds. Access is arranged with us — here's what it covers.

MarketplaceHub has an Orders API for pulling marketplace orders into your own order management system and pushing confirmations, cancellations and refunds back.

Access is arranged with us

There is no self-service credential issuing yet. If you want to integrate against the Orders API, get in touch and we will set your account up and send you the full reference.

We would rather say that plainly than publish an endpoint list you cannot authenticate against.

What it covers

The API is order-side only — listings, imports and price and stock sync are not exposed through it, and are configured in the app instead.

The typical flow is:

1. Poll for orders awaiting fulfilment.
2. Confirm an order once it ships, with the carrier and tracking number.
3. Cancel it instead if you are not going to ship it — before or after confirming.
4. Refund, in whole or in part, where required.

Authentication is OAuth 2.0 against our identity service, with separate read and write scopes so a system that only ingests orders never needs write access.

If you were looking for the old pages

Earlier versions of this site documented an order API at /v2/… endpoints, partly on a domain we no longer use. That documentation described an interface that no longer exists and has been removed rather than left to mislead. Nothing in it should be built against.