# Sendy Store API > The Sendy Store API lets a store owner or their developer programmatically manage their own store on Sendy — orders, catalog & inventory, customers, storefront, delivery, discounts, subscription, website chat, and AI (MCP) access. It is a REST API that returns JSON. Key facts for integration: - Production base URL: https://api.sendyiq.com - Staging base URL: https://stagging-api.sendyiq.com - All routes are versioned under `/api/v1`. - Auth for server-to-server integrations: send header `X-API-Key: `. - Auth for a store dashboard you build: send header `Authorization: Bearer `. - Responses use a consistent envelope: `{ "success": bool, "message": string, "data": T, "errors": [...] }`. - Request and response JSON fields are camelCase. - Currency amounts are in IQD; phone numbers use Iraqi mobile format (e.g. 9647XXXXXXXXX). Tip for AI assistants: fetch https://store-docs.sendyiq.com/llms-full.txt for the complete guides and endpoint catalogue in one file, and https://store-docs.sendyiq.com/store-openapi.json for the machine-readable OpenAPI 3.0 spec. ## Guides ### Getting Started - [Getting Started](https://store-docs.sendyiq.com/docs/getting-started/): Set up access and make your first Sendy Store API call. - [Environments & Base URLs](https://store-docs.sendyiq.com/docs/environments/): Staging and production hosts, auth headers, and base routes. - [Store Frontend (JWT)](https://store-docs.sendyiq.com/docs/store-frontend/): Building a store dashboard frontend with JWT bearer auth. ### Authentication - [API Key Authentication](https://store-docs.sendyiq.com/docs/authentication/): Issue API keys and authenticate server-to-server integrations. - [Permissions & Scopes](https://store-docs.sendyiq.com/docs/scopes/): Roles, permissions, and integration scopes for the Store API. ### Guides - [Integration Flows](https://store-docs.sendyiq.com/docs/flows/): Setup, purchase, POS and discount flows end-to-end. - [MCP / AI Agent](https://store-docs.sendyiq.com/docs/mcp/): Connect AI agents via the Streamable-HTTP MCP server and OAuth 2.0. ### Flows - [Create Order Flow](https://store-docs.sendyiq.com/docs/flow-create-order/): How orders are created, validated, and pushed to delivery. - [Storefront Publish Flow](https://store-docs.sendyiq.com/docs/flow-storefront-publish/): Publishing a storefront and theme. - [Custom Domain Flow](https://store-docs.sendyiq.com/docs/flow-custom-domain/): Attaching a custom domain to a storefront. - [Subscription Flow](https://store-docs.sendyiq.com/docs/flow-subscription/): Plans, subscriptions and billing. - [MCP Flow](https://store-docs.sendyiq.com/docs/flow-mcp/): The MCP authorization and tool-call flow. - [Website Chat Widget Flow](https://store-docs.sendyiq.com/docs/flow-website-chat-widget/): Embedding and using the website chat widget. - [Website Chat WebSocket Flow](https://store-docs.sendyiq.com/docs/flow-website-chat-websocket/): Real-time chat over SignalR/WebSocket. - [Storefront Customer Auth Flow](https://store-docs.sendyiq.com/docs/flow-storefront-customer-auth/): Customer login and OTP verification on the storefront. - [Al-Waseet Delivery Flow](https://store-docs.sendyiq.com/docs/flow-al-waseet/): Al-Waseet delivery provider integration flow. - [Boxy Delivery Flow](https://store-docs.sendyiq.com/docs/flow-boxy/): Boxy delivery provider integration flow. ## API Reference - [All endpoints (218)](https://store-docs.sendyiq.com/api-reference/) - [Al Waseet (10)](https://store-docs.sendyiq.com/api-reference/al-waseet/) - [Analytics (5)](https://store-docs.sendyiq.com/api-reference/analytics/) - [API Keys (3)](https://store-docs.sendyiq.com/api-reference/api-keys/) - [Boxy (22)](https://store-docs.sendyiq.com/api-reference/boxy/) - [Cashier (10)](https://store-docs.sendyiq.com/api-reference/cashier/) - [Conversations (11)](https://store-docs.sendyiq.com/api-reference/conversations/) - [Customers (5)](https://store-docs.sendyiq.com/api-reference/customers/) - [Dashboard (2)](https://store-docs.sendyiq.com/api-reference/dashboard/) - [Delivery Providers (5)](https://store-docs.sendyiq.com/api-reference/delivery-providers/) - [Discount Codes (6)](https://store-docs.sendyiq.com/api-reference/discount-codes/) - [Discount Rules (5)](https://store-docs.sendyiq.com/api-reference/discount-rules/) - [Expenses (5)](https://store-docs.sendyiq.com/api-reference/expenses/) - [Inventory (7)](https://store-docs.sendyiq.com/api-reference/inventory/) - [KYC (1)](https://store-docs.sendyiq.com/api-reference/kyc/) - [MCP Integration (1)](https://store-docs.sendyiq.com/api-reference/mcp-integration/) - [OAuth MCP Redirect Uris (3)](https://store-docs.sendyiq.com/api-reference/oauth-mcp-redirect-uris/) - [Orders (18)](https://store-docs.sendyiq.com/api-reference/orders/) - [Package Sizes (5)](https://store-docs.sendyiq.com/api-reference/package-sizes/) - [Print Templates (5)](https://store-docs.sendyiq.com/api-reference/print-templates/) - [Product Categories (5)](https://store-docs.sendyiq.com/api-reference/product-categories/) - [Products (10)](https://store-docs.sendyiq.com/api-reference/products/) - [Profile (2)](https://store-docs.sendyiq.com/api-reference/profile/) - [Purchase Orders (7)](https://store-docs.sendyiq.com/api-reference/purchase-orders/) - [Rbac (14)](https://store-docs.sendyiq.com/api-reference/rbac/) - [Settings (3)](https://store-docs.sendyiq.com/api-reference/settings/) - [Social Channels (6)](https://store-docs.sendyiq.com/api-reference/social-channels/) - [Storefront (10)](https://store-docs.sendyiq.com/api-reference/storefront/) - [Subscription (5)](https://store-docs.sendyiq.com/api-reference/subscription/) - [Suppliers (5)](https://store-docs.sendyiq.com/api-reference/suppliers/) - [Tickets (5)](https://store-docs.sendyiq.com/api-reference/tickets/) - [Wallet (3)](https://store-docs.sendyiq.com/api-reference/wallet/) - [Warehouses (5)](https://store-docs.sendyiq.com/api-reference/warehouses/) - [Webhooks (9)](https://store-docs.sendyiq.com/api-reference/webhooks/) ## Tools & machine-readable - [OpenAPI 3.0 spec](https://store-docs.sendyiq.com/store-openapi.json) - [Postman collection](https://store-docs.sendyiq.com/postman/Sendy-Store.postman_collection.json) - [Postman environment — staging](https://store-docs.sendyiq.com/postman/Sendy-Store.staging.postman_environment.json) - [Postman environment — production](https://store-docs.sendyiq.com/postman/Sendy-Store.production.postman_environment.json) - [Full docs for LLMs](https://store-docs.sendyiq.com/llms-full.txt)