# Back Market

> Back Market is a global online marketplace dedicated exclusively to refurbished consumer electronics, operating across 17 countries on three regional platforms (EU, North America, Asia-Pacific). For the ~1,800 professional refurbishers who sell on it, Back Market publishes a seller-facing REST API — the "Back Market API Guidelines" — covering the marketplace taxonomy, product and listing management, orders and orderlines, BuyBack trade-ins, Backship deliveries and returns, the Care after-sales platform, and Backbox competitive pricing.

Generated by the API Evangelist enrichment pipeline on 2026-08-02 from the provider's own published surface. Back Market does not publish an llms.txt of its own (probed https://api.backmarket.dev/llms.txt and https://www.backmarket.com/llms.txt — both 404).

## Key facts

- API style: REST over HTTPS, JSON in and out, all paths under `/ws/`
- Contract: OpenAPI 3.0.3, version 0.1.1, published at https://api.backmarket.dev/bundled_openapi.yaml (rendered with Stoplight Elements)
- Operations: 39 across 34 paths; 30 declare an operationId
- Auth: an opaque token from the seller Back Office, sent as `Authorization: Basic <token>`
- Mandatory headers: `Authorization`, `Accept-Language` (country code), `User-Agent` in the form `BM-{CompanyName}-{IntegrationName};company@companydomain.com`, `Content-type: application/json`, `Accept: application/json`
- Rate limits: ~200 requests / 10 seconds at the Cloudflare edge (20 / 10 seconds on catalog), plus per-endpoint limits on the Care surface; 429 on breach
- Data limit: no more than 2,000 SKU lines processed per hour on the listing-update endpoints
- Idempotency: not supported — no Idempotency-Key contract
- Events: none — no webhooks or streaming; poll with `date_modification` / `last_modification_date` filters
- Sandbox: full preproduction mirrors at preprod.backmarket.fr / .com / .co.jp, each needing its own Back Office account and token
- Access: seller accounts are granted only after validation by the Back Market team

## APIs

- [Back Market API](https://api.backmarket.dev/): the seller/partner REST API — catalog, listings, orders, BuyBack, Backship, Care and Backbox. Base URLs https://www.backmarket.com (NA), https://www.backmarket.fr (EU), https://www.backmarket.co.jp (AP).

## Specs

- [OpenAPI 3.0.3 (verbatim)](openapi/back-market-openapi-original.yml): harvested from https://api.backmarket.dev/bundled_openapi.yaml
- [OpenAPI Overlay](overlays/back-market-api-overlay.yaml): API Evangelist enhancements (tags, environments, conventions) applied without mutating the original
- [Spectral ruleset](rules/back-market-rules.yml): Back Market's own API-design ruleset, published as @backmarket-api/rulesets

## Capability surfaces

- Categories: `GET /ws/category/tree`, `GET /ws/category/tree/{categoryId}` — the marketplace taxonomy
- Listings: `GET|POST /ws/listings`, `GET|POST /ws/listings/{listingId}`, `GET /ws/listings/detail` — create and update products and offers; batch writes return a task id
- Tasks: `GET /ws/tasks/{taskId}` — poll the outcome of a batch listing write
- Orders: `get-ws-list-order`, `get-ws-specific-order`, `update-ws-specific-order`, `post-ws-specific-order-invoice`
- Orderlines: `update-ws-specific-orderline` — the unit shipping, refunds and after-sales attach to
- BuyBack: `get-ws-buyback-v1-orders`, `get-ws-buyback-v1-order`, `get-ws-buyback-v1-orders-pending-reply`, `get-ws-buyback-v1-orders-messages`, `post-ws-buyback-v1-orders-messages`, `put-ws-buyback-v1-orders-suspend`, `put-ws-buyback-v1-orders-validate`, `get-ws-counter-offer-reason`, `put-ws-refurbisher-counter-offer`, `get-ws-buyback-v1-listings`, `get-ws-buyback-v1-listing`, `put-ws-buyback-v1-listing`
- Backship: `GetDeliveries`, `GetDelivery`, `GetReturns`, `GetReturn`
- Care (after-sales): `getCareFolderList`, `getCareFolderDetails`, `postProblem`, `postMessage`, `postRefundCreate`, `postItemTransfer`
- Backbox: `GetBackboxData`, plus `GET /ws/backbox/v1/competitors/{listingId}`

## Docs

- [API Guidelines / developer portal](https://api.backmarket.dev/)
- [Getting started](https://api.backmarket.dev/#getting-started)
- [Technical requirements — headers, WAF, rate limits](https://api.backmarket.dev/#technical-requirements)
- [Seller Support Center](https://merchant-support.backmarket.com/hc/en-us)
- [Become a Back Market seller](https://www.backmarket.com/en-us/seller/home)
- [Seller Back Office](https://www.backmarket.com/bo-seller)
- [Terms of service](https://www.backmarket.com/en-us/legal/terms-of-service)
- [Privacy policy](https://www.backmarket.com/en-us/legal/data-protection)
- [security.txt](https://www.backmarket.com/.well-known/security.txt)

## API Evangelist artifacts in this repo

- [Authentication](authentication/back-market-authentication.yml)
- [Conventions](conventions/back-market-conventions.yml)
- [Error catalog](errors/back-market-problem-types.yml)
- [Rate limits](rate-limits/back-market-rate-limits.yml)
- [Sandbox / preprod](sandbox/back-market-sandbox.yml)
- [Lifecycle and versioning](lifecycle/back-market-lifecycle.yml)
- [Conformance](conformance/back-market-conformance.yml)
- [Data model](data-model/back-market-data-model.yml)
- [Candidate MCP tool list](mcp/back-market-mcp.yml)
- [Agent skills](skills/_index.yml)
- [Agentic access contracts](agentic-access/back-market-agentic-access.yml)
- [Domain security](security/back-market-domain-security.yml)
- [Vulnerability disclosure](security/back-market-vulnerability-disclosure.yml)
- [Well-known index](well-known/back-market-well-known.yml)
- [Packages](packages/back-market-packages.yml)

## Not published by Back Market

- No llms.txt, no MCP server, no A2A agent card, no OpenID/OAuth discovery document, no api-catalog
- No first-party client SDK in any language, and no CLI
- No webhooks or AsyncAPI, no changelog, no status page, no SLA, no trust center or named certifications
- No idempotency contract, no Sunset/Deprecation headers, no RateLimit-* headers