Reference
REST API Reference
The full REST surface Suita exposes for agents and integrations, beyond the MCP server.
Alongside the MCP server, every connected store exposes a plain REST API — useful for agents that call HTTP endpoints directly rather than speaking MCP, or for your own integrations.
Endpoints
- GET /ai/products — full catalog with structured attributes
- GET /api/v1/inventory — live stock levels per SKU
- POST /api/v1/shipping/rates — real-time shipping quotes for a cart and destination
- GET /api/v1/search — semantic and keyword product search
- POST /api/v1/checkout — agent-initiated checkout sessions (same behavior as the create_checkout MCP tool)
- GET /api/v1/recommendations — personalized product suggestions
Authentication
Requests to your dashboard account (app.suita.xyz) use a session token from signing in. Requests to a specific store's own endpoints (/ai/products, /mcp, /api/v1/*) are either public read-only feeds or authenticated with that store's API key, depending on the endpoint.