curl --request GET \
--url https://app.thinnest.ai/api/v1/customers \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/customers', 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"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"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"
},
{
"id": "org_a91d7c34-2e6b-4b0f-8c5a-7f3e1d9b2c60",
"name": "Greenleaf Realty",
"externalId": "realty-0017",
"metadata": {
"city": "Bengaluru"
},
"timezone": "Asia/Kolkata",
"allottedCallLines": null,
"archivedAt": null,
"eraseAfter": null,
"createdAt": "2026-09-21T11:40:05.102Z"
}
],
"nextCursor": "MjAyNi0wOS0yMVQxMTo0MDowNS4xMDJafGE5MWQ3YzM0LTJlNmItNGIwZi04YzVhLTdmM2UxZDliMmM2MA"
}{
"error": "`createdAfter` and `createdBefore` are ISO 8601 times, such as 2026-10-06T00:00:00Z."
}{
"error": "Send a valid API key as `Authorization: Bearer <key>`."
}{
"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."
}List Customers
Your customer workspaces, newest first. Deleted customers waiting to be erased are left out unless you ask for them with archived=true. Call it from your own workspace: with the Thinnest-Workspace header it is refused, because a customer has no customers of its own.
curl --request GET \
--url https://app.thinnest.ai/api/v1/customers \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/customers', 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"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"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"
},
{
"id": "org_a91d7c34-2e6b-4b0f-8c5a-7f3e1d9b2c60",
"name": "Greenleaf Realty",
"externalId": "realty-0017",
"metadata": {
"city": "Bengaluru"
},
"timezone": "Asia/Kolkata",
"allottedCallLines": null,
"archivedAt": null,
"eraseAfter": null,
"createdAt": "2026-09-21T11:40:05.102Z"
}
],
"nextCursor": "MjAyNi0wOS0yMVQxMTo0MDowNS4xMDJafGE5MWQ3YzM0LTJlNmItNGIwZi04YzVhLTdmM2UxZDliMmM2MA"
}{
"error": "`createdAfter` and `createdBefore` are ISO 8601 times, such as 2026-10-06T00:00:00Z."
}{
"error": "Send a valid API key as `Authorization: Bearer <key>`."
}{
"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.
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.
Only the customer with this externalId (your own id for it). Exact match.
128true lists only deleted customers that are waiting to be erased; false (the default) lists only live ones.
true, false Only customers created after this ISO 8601 time.
Only customers created before this ISO 8601 time.