Your store

Any key

Seller API v1 · Updated 7 November 2026

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

The store the key belongs to, and what the key may do. A quick way to check a new key works.

Authentication

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

Responses

OK. See the example response with the request examples.

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."
  }
}

Pořád si nevíš rady? Napiš nám, odpovídáme do 2 pracovních dnů.

NextGET List listings

curl https://klodivo.com/api/v1/store \
  -H "Authorization: Bearer kv_live_…"

$ch = curl_init('https://klodivo.com/api/v1/store');
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/store",
    headers={"Authorization": "Bearer kv_live_…"},
)
answer = r.json()

const r = await fetch('https://klodivo.com/api/v1/store', {
  headers: {
    'Authorization': 'Bearer kv_live_…'
  },
});
const answer = await r.json();

200 Response

{
  "store": {
    "id": 12,
    "name": "Oldcastle Bricks",
    "slug": "oldcastle",
    "url": "https://klodivo.com/store/oldcastle",
    "status": "open",
    "currency": "EUR",
    "country": "NL",
    "verified_seller": true,
    "lots": 6624
  },
  "key": {
    "name": "Inventory sync",
    "scope": "write"
  }
}