Skip to main content
The Mart Partner API is a REST API for the catalogue, delivery prices, orders and your account’s money. This reference is generated from its OpenAPI document, openapi.json, which wins if a guide disagrees: tell Mart.

Base URLs

A key works only in its own environment, or answers 401 key_environment_mismatch. Every answer carries X-Mart-Environment. See Quickstart.

Authentication

Send Authorization: Bearer with your key (preferred), or X-Api-Key. Each operation names its scope in x-required-scope; a key without it gets 403 insufficient_scope. GET /api/v1/account needs no scope. See Authenticate and keys.

Envelope

Every answer, success or failure:
string
success or fail.
integer
The HTTP status.
string
Text for people. Never branch on it.
object | null
The result; null on failure.
object | null
Paging, replay flags and cursors; null on failure.
object | null
null on success; code and details on failure.
Keys are stable: an absent object is null and an absent list is []. Only include= on the products listing changes the shape.

Conventions