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 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.
Still stuck? Contact us; we reply within 2 business days.