Get Customers Usage
curl --request GET \
--url https://app.thinnest.ai/api/v1/customers/usage \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/customers/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/customers/usage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"timezone": "UTC",
"from": "2026-09-01",
"to": "2026-09-30",
"currency": "INR",
"totalMicro": 4318200000,
"items": [
{
"customer": "org_8b2e4f6a-1c3d-4e5f-9a7b-0c2d4e6f8a13",
"name": "Mehta Realty",
"externalId": "crm-1042",
"state": "active",
"spendMicro": 3120000000,
"entries": 812,
"byKind": {
"voice_call": 2410000000,
"reply": 710000000
}
},
{
"customer": "org_7Lm2Qp4Rs8Tv1Wx3Yz5AbC",
"name": null,
"externalId": null,
"state": "erased",
"spendMicro": 1198200000,
"entries": 233,
"byKind": {
"wa_message": 1198200000
}
}
]
}Usage
Get Customers Usage
Developers: what each of your customers cost you over a range, in one call — spend net of refunds, how many charges, and spend by kind. Customers with no charges in the range are left out (list them with GET /customers). Without from/to it is this month so far; days are UTC and a range covers at most 366 days. Call it from your own workspace: the Thinnest-Workspace header is refused. Any key may call this, a read-only key included.
GET
/
customers
/
usage
Get Customers Usage
curl --request GET \
--url https://app.thinnest.ai/api/v1/customers/usage \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/customers/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/customers/usage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"timezone": "UTC",
"from": "2026-09-01",
"to": "2026-09-30",
"currency": "INR",
"totalMicro": 4318200000,
"items": [
{
"customer": "org_8b2e4f6a-1c3d-4e5f-9a7b-0c2d4e6f8a13",
"name": "Mehta Realty",
"externalId": "crm-1042",
"state": "active",
"spendMicro": 3120000000,
"entries": 812,
"byKind": {
"voice_call": 2410000000,
"reply": 710000000
}
},
{
"customer": "org_7Lm2Qp4Rs8Tv1Wx3Yz5AbC",
"name": null,
"externalId": null,
"state": "erased",
"spendMicro": 1198200000,
"entries": 233,
"byKind": {
"wa_message": 1198200000
}
}
]
}Authorizations
Query Parameters
Response
Spend per customer.