curl --request GET \
--url https://app.thinnest.ai/api/v1/usage \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/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/usage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"plan": "payg",
"currency": "INR",
"period": {
"start": "2026-10-01T00:00:00.000Z",
"end": "2026-11-01T00:00:00.000Z"
},
"replies": {
"used": 1240,
"included": null,
"metered": true,
"stopped": false
},
"billedTo": "self",
"wallet": {
"balanceMicro": 1850000000,
"availableMicro": 1350000000,
"heldMicro": 500000000,
"creditMicro": 0,
"creditExpiresAt": null
},
"daily": [
{
"day": "2026-10-06",
"replies": 52
},
{
"day": "2026-10-07",
"replies": 61
}
]
}{
"error": "`days` must be a whole number from 1 to 90."
}{
"error": "Send a valid API key as `Authorization: Bearer <key>`."
}{
"error": "Workspace not found."
}{
"error": "Over 240 requests a minute. Slow down and retry."
}Get Usage
Your plan, this calendar month’s (UTC) replies against its allowance, the wallet, and replies per UTC day for the last days — the figures on the console’s Usage page. Any key may call this, a read-only key included.
curl --request GET \
--url https://app.thinnest.ai/api/v1/usage \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/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/usage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"plan": "payg",
"currency": "INR",
"period": {
"start": "2026-10-01T00:00:00.000Z",
"end": "2026-11-01T00:00:00.000Z"
},
"replies": {
"used": 1240,
"included": null,
"metered": true,
"stopped": false
},
"billedTo": "self",
"wallet": {
"balanceMicro": 1850000000,
"availableMicro": 1350000000,
"heldMicro": 500000000,
"creditMicro": 0,
"creditExpiresAt": null
},
"daily": [
{
"day": "2026-10-06",
"replies": 52
},
{
"day": "2026-10-07",
"replies": 61
}
]
}{
"error": "`days` must be a whole number from 1 to 90."
}{
"error": "Send a valid API key as `Authorization: Bearer <key>`."
}{
"error": "Workspace not found."
}{
"error": "Over 240 requests a minute. Slow down and retry."
}Authorizations
Your API key (ta_live_…) from Settings → API keys, sent as Authorization: Bearer <key>. Keep it on a server: it can message every customer you have. A key is full, build or read-only; a request its level does not allow is refused with 403.
Headers
Developers only: the customer workspace this request acts in — its org_… id from POST /customers. Leave it out to act in your own workspace.
"org_3fKq9TzQ1mN8vB2xR7cLpA"
Query Parameters
Days of daily to return, ending today (UTC).
1 <= x <= 90Response
Usage.
Plan, replies this period, wallet and replies per day.
The workspace's plan.
"payg"
The currency money is stated in.
INR, USD The period replies.used counts: this calendar month in UTC.
Show child attributes
Show child attributes
This period's replies against the plan's allowance.
Show child attributes
Show child attributes
developer when this workspace is a developer's customer and its usage is billed to the developer; otherwise self.
self, developer The balance. null on Free (which has no wallet) and for a developer's customer (its developer pays).
Show child attributes
Show child attributes
Replies per UTC day for the last days.
Show child attributes
Show child attributes