List your active phone numbers
curl --request GET \
--url https://api.voice.mergenlab.ai/v1/numbers \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.voice.mergenlab.ai/v1/numbers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.voice.mergenlab.ai/v1/numbers"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)[
{
"number": "+9180XXXXXX79",
"status": "active",
"country": "IN",
"region": "Karnataka",
"type": "local",
"capabilities": {
"voice": true,
"sms": false
}
}
]Account
List your active phone numbers
Your active Mergen numbers, read live from the telephony service. Use them as from (caller ID) for human
calls, reachability checks and voice broadcasts. Not paginated. When the telephony service is down the answer is
503 telephony_unavailable.
GET
/
v1
/
numbers
List your active phone numbers
curl --request GET \
--url https://api.voice.mergenlab.ai/v1/numbers \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.voice.mergenlab.ai/v1/numbers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.voice.mergenlab.ai/v1/numbers"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)[
{
"number": "+9180XXXXXX79",
"status": "active",
"country": "IN",
"region": "Karnataka",
"type": "local",
"capabilities": {
"voice": true,
"sms": false
}
}
]Authorizations
Authorization: Bearer vg_live_<32 hex characters>. Keys are issued by Mergen admins and shown once.
Missing or invalid key: 401 unauthorized. Suspended account: 403 tenant_suspended.
Response
The numbers.
E.164.
Example:
"+9180XXXXXX79"
Always active here.
Example:
"active"
ISO country code.
Example:
"IN"
Example:
"Karnataka"
Number type as the telephony provider reports it, for example local or tollfree.
For example { "voice": true, "sms": false }. Only numbers with voice can be caller IDs.
Show child attributes
Show child attributes