curl --request GET \
--url https://app.thinnest.ai/api/v1/phone-numbers/available \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/phone-numbers/available', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/phone-numbers/available"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"number": "918041234567",
"city": "Bangalore",
"monthlyPrice": {
"amountMinor": 34900,
"currency": "INR"
}
},
{
"number": "918041239876",
"city": "Bangalore",
"monthlyPrice": {
"amountMinor": 34900,
"currency": "INR"
}
}
],
"nextCursor": "20"
}{
"error": "`pattern` must be up to ten digits, like an area code: 80."
}{
"error": "Unauthorized",
"code": "unauthorized"
}{
"error": "Phone numbers need a paid plan. Switch to pay-as-you-go — there is no monthly fee — and top up, because a number is charged every month."
}{
"error": "Workspace not found.",
"code": "workspace_not_found"
}{
"error": "This workspace was deleted on 2026-10-06 and is erased on 2026-11-05. POST /v1/customers/{id}/restore brings it back until then.",
"code": "workspace_deleted"
}{
"error": "Over 240 requests a minute. Slow down and retry.",
"code": "rate_limit_resources",
"limit": {
"name": "resources",
"perMinute": 240
}
}{
"error": "We could not reach the numbering system just now. Try again in a few minutes."
}Search Available Phone Numbers
Local numbers you can rent in your workspace’s region (Indian numbers for a workspace billed in India, United States numbers for one billed anywhere else), each with its monthly rent at your plan’s rate in your balance’s currency. Numbers somebody already holds are left out, so a page (up to twenty) can hold fewer and still have more after it: pass nextCursor back as cursor. Needs a paid plan.
curl --request GET \
--url https://app.thinnest.ai/api/v1/phone-numbers/available \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/phone-numbers/available', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/phone-numbers/available"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"number": "918041234567",
"city": "Bangalore",
"monthlyPrice": {
"amountMinor": 34900,
"currency": "INR"
}
},
{
"number": "918041239876",
"city": "Bangalore",
"monthlyPrice": {
"amountMinor": 34900,
"currency": "INR"
}
}
],
"nextCursor": "20"
}{
"error": "`pattern` must be up to ten digits, like an area code: 80."
}{
"error": "Unauthorized",
"code": "unauthorized"
}{
"error": "Phone numbers need a paid plan. Switch to pay-as-you-go — there is no monthly fee — and top up, because a number is charged every month."
}{
"error": "Workspace not found.",
"code": "workspace_not_found"
}{
"error": "This workspace was deleted on 2026-10-06 and is erased on 2026-11-05. POST /v1/customers/{id}/restore brings it back until then.",
"code": "workspace_deleted"
}{
"error": "Over 240 requests a minute. Slow down and retry.",
"code": "rate_limit_resources",
"limit": {
"name": "resources",
"perMinute": 240
}
}{
"error": "We could not reach the numbering system just now. Try again in a few minutes."
}Authorizations
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. Refused with 404 (Workspace not found.) when the id is unknown, is not one of your customers, or is not an org_… id; 410 when that customer was deleted (restore it with POST /customers/{id}/restore until it is erased); 403 when the key belongs to one customer workspace (it cannot act as another); 400 when your workspace is not a developer workspace. /customers/* and GET /customers/usage are your own workspace's and refuse the header with 400: call them without it.
"org_3fKq9TzQ1mN8vB2xR7cLpA"