curl --request GET \
--url https://app.thinnest.ai/api/v1/usage/calls \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/usage/calls', 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/calls"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"id": "call_8hT2kQ9vXzLm4Rb",
"startedAt": "2026-10-06T10:14:22.000Z",
"direction": "outbound",
"surface": "phone",
"status": "completed",
"outcome": {
"kind": "answered",
"label": "Answered"
},
"seconds": 184,
"number": "+919820012345",
"from": "+918069001122",
"machine": false,
"agent": {
"id": "ag_3fKq9TzQ1mN8vB2x",
"name": "Sharma Clinic Receptionist"
},
"costMicro": 18400000,
"currency": "INR",
"hasRecording": true
}
],
"nextCursor": "MjAyNi0xMC0wNlQxMDoxNDoyMi4wMDBa"
}List Call Log
The Usage page’s call log: every call made or taken, newest first, with how it ended and what it was charged. format=csv returns the console’s export instead — the same calls, up to 10,000, as a calls.csv attachment (columns Started, Direction, Surface, Agent, Number, From, Outcome, Status, Seconds, Cost); limit and cursor do not apply to it. GET /calls is the integration view of the same calls; this is the billing view. Any key may call this, a read-only key included.
curl --request GET \
--url https://app.thinnest.ai/api/v1/usage/calls \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/usage/calls', 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/calls"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"id": "call_8hT2kQ9vXzLm4Rb",
"startedAt": "2026-10-06T10:14:22.000Z",
"direction": "outbound",
"surface": "phone",
"status": "completed",
"outcome": {
"kind": "answered",
"label": "Answered"
},
"seconds": 184,
"number": "+919820012345",
"from": "+918069001122",
"machine": false,
"agent": {
"id": "ag_3fKq9TzQ1mN8vB2x",
"name": "Sharma Clinic Receptionist"
},
"costMicro": 18400000,
"currency": "INR",
"hasRecording": true
}
],
"nextCursor": "MjAyNi0xMC0wNlQxMDoxNDoyMi4wMDBa"
}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
How many items to return, 1 to 100.
1 <= x <= 100The nextCursor from the previous page. Leave it out for the first page.
First day, YYYY-MM-DD, inclusive, in your workspace's time zone. Optional; either end alone is allowed.
Last day, YYYY-MM-DD, inclusive, in your workspace's time zone. Optional.
json (a page) or csv (the export, as an attachment).
json, csv