Skip to content

Developers

Build on the commerce system of record

REST APIs for orders, inventory, fulfillment, invoices and storefronts, an MCP server for agents, and docs written for people and for coding agents.

  • Scoped API keys
  • Idempotent writes
  • Production and sandbox base URLs
  • llms.txt for coding agents
List your sales channels
curl -s https://apis.kentro.live/channel/v1/channels \
  -H "kentro-key: $KENTRO_KEY" \
  -H "kentro-secret: $KENTRO_SECRET"

What is a headless ecommerce API?

A headless ecommerce API lets you build your own storefront, app or agent on a commerce back end without using its front end. Kentro's Store API, part of Kentro Storefront, covers buyer sign-in, the catalog at each buyer's prices, cart, quotes and checkout. The Channel API moves orders, stock, shipments and invoices in and out of Kentro.

Keys and conventions

API keys, scopes and safe retries

Admins create keys in Kentro OS under Users, API keys. A key belongs to one workspace and carries the scopes of the permission groups you assign: channel:read for reporting, channel:write for a full integration. A key can be bound to chosen sales channels.

Send the key and secret as the kentro-key and kentro-secret headers, or exchange them for a short-lived bearer token. Every write takes an Idempotency-Key header, so a retry replays the original answer instead of writing twice.

  • Production: https://apis.kentro.live/channel
  • Sandbox: https://apis.kentro.dev/channel, with its own workspaces and data
  • Store API: https://apis.kentro.live/store/v1
  • No webhooks on the Channel API: integrations poll with updatedSince
Channel API getting started
Response
{
  "data": [
    {
      "id": "64f0aabb-ccdd-1122-3344-000100000000",
      "name": "Web store",
      "type": "woocommerce",
      "isActive": true,
      "currency": "USD"
    }
  ],
  "nextCursor": null,
  "limit": 50
}

Start building on Kentro

Read the docs, or create a workspace and generate your API keys.

Choose what this site may use. Necessary storage is always on.

  • Necessary

    Remembers this choice for 12 months and keeps forms safe from spam. No tracking.

    Always on

Cookie policyPrivacy policy