List listings

Any key

Seller API v1 · Updated 7 November 2026

GEThttps://klodivo.com/api/v1/inventory

Your listings, newest change first, 100 a page.

Authentication

API key in the header Authorization: Bearer kv_live_…. Any key works, also Read only. Create keys under Your store → API.

Query parameters

Name	Type	Description
status	string	active, sold_out or hidden.
updated_since	string	Only listings changed since this time (ISO 8601, like 2026-11-02T08:00:00Z). Use it to sync changes.
page	integer	Page number, from 1.
per_page	integer	Results per page, 1 to 200 (default 100).

Responses

OK. total is the number of matching listings. See the example response with the request examples.

A filter has a value it can't use.

{
  "error": {
    "code": "invalid_status",
    "message": "status is active, sold_out or hidden."
  }
}

Missing, unknown or revoked key.

{
  "error": {
    "code": "unauthorized",
    "message": "This API key doesn't exist or was revoked."
  }
}

Too many requests. Wait the seconds in Retry-After.

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: up to 120 a minute per key. Try again in 12 s."
  }
}

Still stuck? Contact us; we reply within 2 business days.

PreviousGET Your store NextGET Get a listing

curl https://klodivo.com/api/v1/inventory?status=active&updated_since=2026-11-01T00:00:00Z \
  -H "Authorization: Bearer kv_live_…"

$ch = curl_init('https://klodivo.com/api/v1/inventory?status=active&updated_since=2026-11-01T00:00:00Z');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer kv_live_…'],
]);
$answer = json_decode(curl_exec($ch), true);

import requests

r = requests.get(
    "https://klodivo.com/api/v1/inventory?status=active&updated_since=2026-11-01T00:00:00Z",
    headers={"Authorization": "Bearer kv_live_…"},
)
answer = r.json()

const r = await fetch('https://klodivo.com/api/v1/inventory?status=active&updated_since=2026-11-01T00:00:00Z', {
  headers: {
    'Authorization': 'Bearer kv_live_…'
  },
});
const answer = await r.json();

200 Response

{
  "data": [
    {
      "id": 48213,
      "external_ref": "A1-6080",
      "item": {
        "type": "set",
        "no": "6080-1",
        "name": "King's Castle",
        "bricklink_no": "6080-1"
      },
      "color": null,
      "kind": "item",
      "state": "used",
      "grade": "good",
      "completeness": "complete",
      "has_box": true,
      "has_instructions": true,
      "notes": "Built once, kept in a display case.",
      "quantity": 3,
      "price": "12.50",
      "currency": "EUR",
      "status": "active",
      "photos": [
        "https://klodivo.com/uploads/3f9a…-l.webp"
      ],
      "url": "https://klodivo.com/set/6080-1",
      "created_at": "2026-10-02T09:14:03Z",
      "updated_at": "2026-11-07T10:24:51Z"
    }
  ],
  "page": 1,
  "per_page": 100,
  "total": 1
}