ZiadaPOS developer docs

The shop platform, from first request to daily operations

Use these guides to connect to ZiadaPOS, understand its business workflows, and integrate the REST API or MCP agent. Endpoint behavior and examples follow the ZiadaPOS API implementation (opens in a new tab).

What ZiadaPOS supports

ZiadaPOS is a multi-store point-of-sale and shop management platform. Its Go API covers account access, inventory, checkout, customers and credit, suppliers, expenses, staff, reporting, subscriptions, notifications, AI conversations, and pharmacy workflows. The API is the source of truth for available routes and behavior; the API reference is organized by those implemented domains.

The separate MCP agent exposes selected API operations as tools and can interpret English and Swahili requests. It is an integration layer: permissions, validation, and business rules are enforced by the API.

First integration steps

1. Choose the API host and confirm its configured base path (usually /api/v1).
2. Register and verify an account, or use an existing account to sign in.
3. Send the access token as Authorization: Bearer <access_token>.
4. Use the active store in the token context; switch stores through the account endpoint when needed.
5. Check each domain guide for permissions, request fields, and workflow effects.

Find a guide