GET analytics revenue
Read daily revenue analytics by store.
Endpoint
GET /public-api/v1/analytics/revenuePurpose
Returns paid-sale revenue by date and store for the selected date range.
Authentication
Required.
Parameters
storeIds: optional branch filter.from: optional ISO timestamp.to: optional ISO timestamp.
Response fields
Each row includes date, storeId, storeName, revenue, txCount, and avgOrderValue.
Example request
curl "https://api.klupos.com/public-api/v1/analytics/revenue?from=2026-06-01T00:00:00.000Z&to=2026-06-24T23:59:59.999Z" \
-H "Authorization: Bearer klu_live_replace_me"Example response
{
"data": [
{
"date": "2026-06-24",
"storeId": "store-id",
"storeName": "Main Branch",
"revenue": 12500,
"txCount": 32,
"avgOrderValue": 390.625
}
],
"meta": {
"dateRange": {
"from": "2026-06-01T00:00:00.000Z",
"to": "2026-06-24T23:59:59.999Z"
}
}
}Common errors
400: invalid date range or store UUID.401: invalid key.403: requestedstoreIdsare outside the organization.429: rate limit exceeded.
AI-agent notes
Prefer this endpoint for revenue trend questions. It already filters to paid sales.