API
Developer & API·Available today

Public REST API

Every surface in the dashboard, available as a versioned REST endpoint.

The same endpoints the Distribu dashboard calls are available to you under /api/v1. Scoped keys, 60 req/min per key, standard rate-limit headers, idempotency keys on writes, and versioned URLs so your integration doesn't break when we ship.

What it does

  • Products, orders, customers, inventory, returns, and webhooks
  • Per-key scopes (products:read, orders:write, …) enforced on every request
  • Idempotency-Key support on POSTs so retries are safe
  • Per-key and per-IP rate limits with X-RateLimit-* headers

Create an order via the API

curl https://distribu.app/api/v1/orders \
  -H "Authorization: Bearer $DISTRIBU_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cus_...",
    "items": [{ "productId": "prod_...", "quantity": 12 }]
  }'

Ready to wire it up?

Start a free trial and you'll have an API key and webhook endpoint ready to point at Public REST API in under a minute.