Klovio REST API.

Base URL

https://api.klovio.app/v1

Authentication

All API requests require a bearer token. Generate API keys in Settings → Developers → API keys. Keys are scoped per environment (sandbox / production) and per role.

curl https://api.klovio.app/v1/inventory \
  -H "Authorization: Bearer klv_live_********************"

Rate limits

• Standard: 1,000 requests / minute / API key
• Bulk endpoints: 100 requests / minute
• Webhooks: No outbound limit; we retry failed deliveries with exponential backoff for up to 24 hours

Rate-limit headers are included on every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Resources

Inventory

• GET /inventory — list all SKUs with current on-hand quantities
• GET /inventory/:sku — retrieve a single SKU
• POST /inventory — create a new SKU
• PATCH /inventory/:sku — update SKU fields
• DELETE /inventory/:sku — archive a SKU

Locations

• GET /locations — list warehouses, aisles, shelves, bins
• POST /locations — create a new location
• POST /locations/:id/transfer — transfer stock between locations

Orders

• GET /orders — list orders, filtered by status
• POST /orders — create an order (from external system)
• POST /orders/:id/pack — mark order as packed
• POST /orders/:id/ship — mark order as shipped, decrement inventory

Scans

• POST /scans — record a scan event (advanced; most users use the mobile app)
• GET /scans — paginated scan history

Example request

curl https://api.klovio.app/v1/inventory \
  -H "Authorization: Bearer klv_live_********************" \
  -H "Content-Type: application/json" \
  -d '{
    "sku": "OOL-001-1L",
    "name": "Organic Olive Oil 1L",
    "on_hand": 248,
    "reorder_point": 50,
    "location": "aisle-a/shelf-3"
  }'

Webhooks

Subscribe to events via Settings → Developers → Webhooks. Available events:

• inventory.updated — fired on any quantity change
• inventory.low_stock — fired when SKU drops below reorder point
• order.created · order.packed · order.shipped
• scan.completed — fired on every scan (high volume — filter carefully)

Payloads are signed with HMAC-SHA256. Verify the Klovio-Signature header against your webhook secret.

SDKs

• Node.js: npm install @klovio/node
• Python: pip install klovio
• Ruby: gem install klovio
• Go: go get github.com/klovio/go-sdk