Seller API reference v1.4
mpapis is a unified REST API over marketplace seller accounts. One token, one schema for orders, stock and sales reports across connected stores.
Access is invite-only during the private beta. Base URL: https://api.mpapis.ru/v1
Authentication
Every request carries a bearer token issued for a workspace. Tokens are scoped (orders:read, stock:write, reports:read).
curl https://api.mpapis.ru/v1/orders?status=new \ -H "Authorization: Bearer $MPAPIS_TOKEN"
Rate limit: 60 requests per minute per token. Responses include X-RateLimit-Remaining and Retry-After on 429.
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /stores | Connected marketplace stores |
| GET | /orders | Orders, filterable by status, store_id, updated_since |
| GET | /orders/{id} | Single order with items and shipment |
| GET | /stock | Stock levels per SKU and warehouse |
| PUT | /stock/{sku} | Set available quantity for a SKU |
| POST | /reports | Request a sales report (async) |
| GET | /reports/{id} | Report status and download link |
The full schema is published as OpenAPI 3.1 (YAML).
Pagination
List endpoints are cursor-paginated: pass limit (max 200) and the next_cursor from the previous page.
{
"data": [ { "id": "ord_8f2k1", "status": "new", "total": 2490.00, "currency": "RUB" } ],
"next_cursor": "eyJpZCI6Im9yZF84ZjJrMSJ9"
}
Errors
| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_request | Malformed parameters |
| 401 | unauthorized | Missing or expired token |
| 403 | insufficient_scope | Token lacks the required scope |
| 404 | not_found | Unknown resource |
| 429 | rate_limited | Slow down, see Retry-After |
Changelog
- 1.4 —
updated_sincefilter on/orders; report generation is now async. - 1.3 — warehouse breakdown in
/stock. - 1.2 — cursor pagination replaces page numbers.