Seller API
v1Updated 7 November 2026
Keep your klodivo store in step with your inventory software: read and change your listings, and see and ship your orders. JSON over HTTPS.
Base addresshttps://klodivo.com/api/v1
Quick start
- Create a key under Your store → API. Choose Read only or Read and write. It's shown once.
- Send it with every request in the Authorization header.
- Call GET /store to check it works.
Authentication
Authorization: Bearer kv_live_…
Make one key per tool, so you can revoke one without breaking the others. A Read only key can't change anything. Keys are stored only as a fingerprint: we can't show a key again, so keep it safe.
Make one key per tool, so you can revoke one without breaking the others. A Read only key can't change anything. Keys are stored only as a fingerprint: we can't show a key again, so keep it safe.
Rate limits
| Requests | Limit per key |
|---|---|
| All calls | 120 a minute |
| Create or update many | 10 a minute |
Above the limit you get 429 with a Retry-After header.
Errors
Errors come back as {"error": {"code": "…", "message": "…", "fields": {…}}} with the matching status.
| Status | Meaning |
|---|---|
| 400 | The request can't be read (not JSON, wrong types, unknown filter). |
| 401 | Missing, unknown or revoked key. |
| 403 | Read only key, or the store is suspended or closed. |
| 404 | Not found. |
| 409 | Not possible now, for example shipping a cancelled order. |
| 413 | Too many items in one request. |
| 422 | Field errors, listed in fields. |
| 429 | Too many requests. |
Endpoints
StoreGET/storeYour store
InventoryGET/inventoryList listingsGET/inventory/{id}Get a listingPOST/inventoryCreate a listingPATCH/inventory/{id}Update a listingDELETE/inventory/{id}Delete a listingPOST/inventory/bulkCreate or update manyPOST/inventory/{id}/photosAdd a photoDELETE/inventory/{id}/photos/{n}Remove a photo
OrdersGET/ordersList ordersGET/orders/{number}Get an orderPOST/orders/{number}/packMark packedPOST/orders/{number}/shipMark shipped
Prefer files? Imports (BrickLink XML, BrickStore or CSV) and the BrickLink XML export keep working too. Using the API means accepting the Seller API terms.
Toujours bloqué ? Contactez-nous ; nous répondons sous 2 jours ouvrés.