API reference · v1.0.0

API reference

Every endpoint of the Dropship API. This reference is generated from the live OpenAPI document, so it always matches the API.

Base URL

https://backend.markitmall.com/dropship/v1

Authenticate every call with Authorization: Bearer <keyId>:<secret> (details). Errors follow one shape (codes). Every endpoint has a Try it panel that calls the sandbox with your test key, or import openapi.json into Postman.

Account#

get/meWho this key belongs to (test connection)post/integration/disconnectDisconnect this store (app or plugin uninstalled)

Catalog#

get/catalog/productsBrowse dropship products get/catalog/products/{id}One product with variants, prices and stock get/catalog/categoriesCategory tree (only categories with dropship products)get/inventoryStock and price for up to 100 variants

Imports#

get/importsYour imported products and their sync status post/importsMark products as imported and map your variant ids to ours delete/imports/{id}Stop syncing a product post/imports/{id}/sync-resultReport whether applying our last change to your store worked

Orders#

get/ordersList orders post/ordersCreate an order get/orders/{id}Order (parcel) detail with status history and tracking get/orders/{id}/trackingCustomer-safe tracking: stage, courier, tracking number and a dated timeline post/orders/{id}/cancelCancel before it is packed post/orders/{id}/payPay an AWAITING_FUNDS order from your wallet post/orders/{id}/simulateSandbox only: move a test order to a stage and receive its webhook

Shipping#

post/shipping/quoteShipping cost for a city and items, before you place the order

Wallet#

get/walletAvailable, pending and held balances get/wallet/transactionsLedger entries, newest first, each linked to its order

Webhooks#

get/webhooksYour webhook URL and events put/webhooksSet your webhook URL and events post/webhooks/testSend a sample order.shipped event get/webhooks/deliveriesDelivery log