Developer docs

Build on the AiMonk API

Versioned REST endpoints, tenant-scoped API keys, and comprehensive Swagger documentation - everything you need to go headless.

Clean REST endpoints with consistent JSON responses. Versioned at /v1 for stability.

Every request is scoped to the authenticated tenant. Cross-tenant access is impossible.

Short, medium, and long rate limit buckets. Enterprise plans get higher throughput.

Full OpenAPI/Swagger documentation available at /api/docs on your API instance.

Quick start

Four steps to your first API call.

Get your API key

Admin Console → Settings → API Keys → Generate

Authenticate requests

Authorization: Bearer <your-api-key>

Fetch products

GET /storefront/v1/products?limit=20

Create an order

POST /storefront/v1/orders { lineItems, address, payment }

Key endpoint groups from the storefront and admin APIs.

Browse products, search with autocomplete, filter by category, and fetch product details with variants.

GET/v1/productsList products with pagination and filters

GET/v1/products/:slugProduct detail with variants and reviews

GET/v1/products/searchFull-text search with autocomplete

GET/v1/categoriesBrowse product categories

Stateless cart quotes, stock verification, shipping calculation, and multi-step checkout.

POST/v1/cart/quotePrice and verify cart line items

POST/v1/checkout/validateValidate checkout readiness

POST/v1/ordersCreate order with payment

GET/v1/shipping/quoteCalculate shipping rates

JWT-based customer auth, API key auth for headless clients, and password management.

POST/v1/auth/registerRegister a new customer

POST/v1/auth/loginAuthenticate and receive JWT

POST/v1/auth/forgot-passwordTrigger password reset email

PATCH/v1/auth/change-passwordUpdate password (authenticated)

Subscribe to order, payment, and storefront events with signature-verified webhooks.

POST/admin/webhooksRegister a webhook endpoint

GET/admin/webhooksList registered webhooks

DELETE/admin/webhooks/:idRemove a webhook

Wire www to this export, point wildcard DNS at your storefront app, and keep admin on its own origin.