Public API overview
Use the read-only Klu POS Public API for AI agents, reporting jobs, and server-side dashboards.
The Klu POS Public API lets approved organizations read selected business data from Klu without giving an integration access to the internal Dashboard or POS APIs.
It is designed for:
- AI agents that answer business questions such as revenue, sales trends, top products, and inventory status
- Server-side dashboards and BI jobs
- Internal reporting automations owned by the customer
The API is read-only. It accepts only GET requests and is mounted at:
https://api.klupos.com/public-api/v1What it exposes
The first version exposes:
- Organization/key metadata
- Branches
- Categories
- Products and product detail with current per-store average cost
- Active and inactive promotion rules with store, category, product, and safe customer-name assignments
- Current inventory and timestamped stock movement history
- Safe staff profiles, observed shift records, staff revenue, and staff discount analytics
- Safe customer profiles and top customer spend analytics
- Sales summaries with compact line items and full sale detail
- Revenue, product, payment method, staff, and customer analytics
Every response is scoped to the organization behind the API key. If no storeIds filter is provided, the key reads all current branches in that organization.
What it does not expose
The API exposes current per-store averageCost on product branch overrides and inventory stock rows. It intentionally excludes historical and supplier cost details, calculated profit, customer contact fields, birthdays, document IDs, prescriptions, member numbers, sale notes, staff emails, pins, Clerk IDs, Zoho IDs, internal inventory-log reasons and actors, and internal file metadata. Staff and customer endpoints expose safe profile fields plus business metrics only.
Response envelope
Most responses use the same envelope:
{
"data": [],
"pagination": {
"nextCursor": "uuid-if-another-page-exists"
},
"meta": {
"dateRange": {
"from": "2026-06-01T00:00:00.000Z",
"to": "2026-06-24T23:59:59.999Z"
}
}
}pagination and meta appear only when relevant.