curl --request GET \
--url https://app.thinnest.ai/api/v1/customers/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/customers/{id}', 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/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "org_5b2f9c1e-8a4d-4f7b-9e3a-2c6d1f0a7b84",
"name": "Sunrise Dental Clinic",
"externalId": "clinic-0042",
"metadata": {
"city": "Pune",
"tier": "gold",
"seats": 3
},
"timezone": "Asia/Kolkata",
"allottedCallLines": 2,
"archivedAt": null,
"eraseAfter": null,
"createdAt": "2026-10-02T06:14:22.418Z",
"counts": {
"agents": 2,
"phoneNumbers": 1,
"contacts": 418
},
"spendThisMonthMicro": 412500000
}{
"error": "Manage customers without the Thinnest-Workspace header: they belong to your own workspace."
}{
"error": "Send a valid API key as `Authorization: Bearer <key>`."
}{
"error": "Customer not found."
}{
"error": "This workspace resells the console under white label: its workspaces are clients, managed in White label → Clients, not API customers."
}{
"error": "Over 240 requests a minute. Slow down and retry."
}Get Customer
One customer, with how many agents, active phone numbers and contacts it has and what its usage has cost you since the 1st of this month (UTC). Deleted customers waiting to be erased are found too.
curl --request GET \
--url https://app.thinnest.ai/api/v1/customers/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/customers/{id}', 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/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "org_5b2f9c1e-8a4d-4f7b-9e3a-2c6d1f0a7b84",
"name": "Sunrise Dental Clinic",
"externalId": "clinic-0042",
"metadata": {
"city": "Pune",
"tier": "gold",
"seats": 3
},
"timezone": "Asia/Kolkata",
"allottedCallLines": 2,
"archivedAt": null,
"eraseAfter": null,
"createdAt": "2026-10-02T06:14:22.418Z",
"counts": {
"agents": 2,
"phoneNumbers": 1,
"contacts": 418
},
"spendThisMonthMicro": 412500000
}{
"error": "Manage customers without the Thinnest-Workspace header: they belong to your own workspace."
}{
"error": "Send a valid API key as `Authorization: Bearer <key>`."
}{
"error": "Customer not found."
}{
"error": "This workspace resells the console under white label: its workspaces are clients, managed in White label → Clients, not API customers."
}{
"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.
Path Parameters
The customer's id (org_…), as Create Customer answered.
Response
The customer.
A customer, with its counts and this month's spend.
The customer's id (org_…). Send it as Thinnest-Workspace to act inside this customer.
"org_5b2f9c1e-8a4d-4f7b-9e3a-2c6d1f0a7b84"
The customer's name.
120"Sunrise Dental Clinic"
Your own id for this customer, unique among your customers; null when you gave none.
"clinic-0042"
Your own flat key-value data about the customer: up to 50 keys of 1-40 characters, each value a string (up to 500 characters), a number or a boolean. No nested objects or lists; 8 KB in all.
Show child attributes
Show child attributes
{
"city": "Pune",
"tier": "gold",
"seats": 3
}
The customer's IANA time zone; every date its console shows is in it.
"Asia/Kolkata"
How many of your call lines this customer may use at once; null for no cap.
x >= 02
When the customer was deleted; null while it is live.
null
When a deleted customer will be erased for good (30 days after deletion); null while it is live.
null
When the customer was created.
"2026-10-02T06:14:22.418Z"
What the customer holds.
Show child attributes
Show child attributes
What this customer's usage has cost you since the 1st of this month (UTC), in millionths of your currency: 412500000 is ₹412.50.
412500000