Store API
Catalogue browsing, search, cart, checkout, accounts, orders, wishlists, gift registries,
and more. Namespaced under /api/v1/store/....
Admin API
Catalogue, orders, customers, store configuration, webhooks, and bulk data transfer.
Namespaced under /api/v1/admin/....
What calling it actually looks like
# One header, real products back.
curl https://your-store.example.com/api/v1/store/search/products?limit=3 \
-H "X-Commerce-Key: pk_store_yourstore_<secret>"
# {
# "products": [ { "productId": 501, "name": "...", "pricing": { "price": "R249.00" }, ... } ],
# "total": 128, "page": 1, "pageSize": 3
# }
Client SDKs
Auto-generated straight from the Store API's OpenAPI document, so method signatures stay in sync as the API evolves. Prefer to call the REST API directly? That works too - the SDKs are a convenience, not a requirement.
Published on npm, PyPI, Packagist and NuGet, all four cut from the same release so their version numbers always match.
TypeScript
npmnpm install @ordereazi/commerce-sdk
Python
PyPIpip install ordereazi-commerce-sdk
PHP
Packagistcomposer require ordereazi/commerce-sdk
C#
NuGetdotnet add package OrderEazi.Commerce.Sdk
AI Agent Toolkit New
An MCP server + CLI you install into your own coding agent (Claude Code, Cursor, VS Code) so it can build a headless storefront here without guessing at endpoints or SDK method names - search the API docs, resolve an operation to the exact generated method name per language, scaffold a working starter storefront, and check that a key actually works, all as tools the agent calls directly.
Published on npm as @ordereazi/commerce-agent-toolkit - no checkout and no build
step, npx fetches it on first use.
1. Install into your agent
npx @ordereazi/commerce-agent-toolkit init
2. Or scaffold one directly
npx @ordereazi/commerce-agent-toolkit create my-storefront
Once it's wired in, just tell your agent what you want:
"Build me a complete headless storefront called my-storefront, wired to
https://your-store.example.com. My Store Access Key is: pk_store_yourstore_<secret>.
Install dependencies and start the dev server."
That's the whole prompt - the agent scaffolds a working React + TypeScript storefront (browse, search, cart, checkout, orders, account), wires up your key, and runs it. No hand-written API client, no guessed endpoint names.
How it works
Get a key
Create a Store or Admin Application Key in Backoffice under Settings > Application APIs.
Authenticate
Send it as X-Commerce-Key, scoped to only the permissions your integration needs.
Start building
Explore and test every endpoint directly from the reference docs - no separate client needed.