Klatchit Seller API

A REST API for managing your store's listings, inventory, and shipping — the same operations as the seller dashboard, automatable.

Authentication

Every request needs a store API key as a Bearer token. Create one under Seller dashboard → API keys (owners only). The secret is shown once.

curl https://klatchit.com/api/v1/listings \
  -H "Authorization: Bearer klk_live_<key_id>.<secret>"

All money is integer cents.
Lists use keyset cursor pagination (limit ≤ 100, cursor, next_cursor).
Sync with updated_since (ISO-8601 or Unix seconds).
Mutations accept an Idempotency-Key header for safe retries.
Errors are { error: { type, code, message, param, request_id } }; every response carries X-Request-Id.
Rate limits surface via X-RateLimit-* headers; a 429 includes Retry-After.

Method	Path	Scope	Description
GET	/v1/listings	listings:read	List listings (updated_since sync feed)
POST	/v1/listings	listings:write	Create a listing
GET	/v1/listings/:id	listings:read	Retrieve a listing
PATCH	/v1/listings/:id	listings:write	Update a listing
POST	/v1/listings/:id/publish	listings:write	Publish (activate) a listing
POST	/v1/listings/:id/status	listings:write	Set listing status
POST	/v1/inventory/batch	listings:write	Apply up to 100 stock adjustments
GET	/v1/shipping-templates	listings:read	List shipping templates
POST	/v1/shipping-templates	shipping:write	Create a shipping template
PATCH	/v1/shipping-templates/:id	shipping:write	Update a shipping template