List Account Phone Numbers

GET

api

Account

{auth_id}

numbers

List phone numbers

curl --request GET \
  --url https://api.vobiz.ai/api/v1/Account/{auth_id}/numbers \
  --header 'X-Auth-ID: <api-key>' \
  --header 'X-Auth-Token: <api-key>'

import requests

url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/numbers"

headers = {
    "X-Auth-ID": "<api-key>",
    "X-Auth-Token": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};

fetch('https://api.vobiz.ai/api/v1/Account/{auth_id}/numbers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "items": [
    {
      "id": "aabbccdd-1234-5678-90ab-cdef12345678",
      "account_id": "MA_XXXXXXXX",
      "e164": "+919876543210",
      "country": "IN",
      "region": "Karnataka",
      "capabilities": {
        "voice": true,
        "sms": false,
        "mms": false,
        "fax": false
      },
      "status": "active",
      "provider": "",
      "setup_fee": 100,
      "monthly_fee": 300,
      "currency": "INR",
      "application_id": "20577609616603585",
      "voice_enabled": true,
      "tags": [],
      "purchased_at": "2026-03-25T06:58:38.796024Z",
      "is_blocked": false,
      "created_at": "2026-03-25T18:30:00Z",
      "updated_at": "2026-03-25T06:58:54.752187Z",
      "is_trial_number": false,
      "last_billing_date": "2026-03-25T06:58:38.796024Z",
      "next_billing_date": "2026-04-25T06:58:38.796024Z",
      "minimum_commitment_months": 0,
      "aadhaar_verification_required": false,
      "aadhaar_verified": false,
      "source": "purchased"
    },
    {
      "id": "11223344-5566-7788-99aa-bbccddeeff00",
      "account_id": "MA_XXXXXXXX",
      "e164": "+912271263984",
      "country": "IN",
      "region": "Mumbai",
      "capabilities": {
        "voice": true,
        "sms": false,
        "mms": false,
        "fax": false
      },
      "status": "active",
      "provider": "",
      "setup_fee": 100,
      "monthly_fee": 200,
      "currency": "INR",
      "application_id": "31985999331899218",
      "voice_enabled": true,
      "tags": [],
      "purchased_at": "2026-03-25T10:25:30.672202Z",
      "is_blocked": false,
      "created_at": "2026-03-25T09:30:04.541115Z",
      "updated_at": "2026-03-25T10:29:35.330503Z",
      "is_trial_number": false,
      "last_billing_date": "2026-03-25T10:25:30.672202Z",
      "next_billing_date": "2026-04-25T10:25:30.672202Z",
      "minimum_commitment_months": 0,
      "aadhaar_verification_required": false,
      "aadhaar_verified": false,
      "source": "purchased"
    }
  ],
  "page": 1,
  "per_page": 25,
  "total": 24
}

GET https://api.vobiz.ai/api/v1/Account/{auth_id}/numbers

Returns a list of phone numbers purchased and assigned to your account.

Authentication required:

X-Auth-ID - Your Auth ID (e.g., {auth_id})
X-Auth-Token - Your account Auth Token
Content-Type: application/json

Query Parameters

Field	Type	Required	Description
`page`	integer	No	Page number, starting at `1`. Default: `1`.
`per_page`	integer	No	Number of records per page. Default: `25`.
`search`	string	No	Filter by phone number. Include the country code. For an E.164 number, URL-encode the leading `+` as `%2B` or use `--data-urlencode`.

The request and response both use page and per_page. The limit and offset parameters do not control pagination for this endpoint.

from_date and to_date are not supported filters for this endpoint. Use search to filter by phone number.

Master Accounts (MA_): results from a master account include numbers owned by its sub-accounts (SA_). Each item’s account_id tells you which account owns it.

Request

cURL

curl --get "https://api.vobiz.ai/api/v1/Account/{auth_id}/numbers" \
  --data-urlencode "page=1" \
  --data-urlencode "per_page=20" \
  -H "X-Auth-ID: {auth_id}" \
  -H "X-Auth-Token: {auth_token}"

Search owned numbers

Use --data-urlencode to preserve the leading + in an E.164 number. Writing a raw + in a query string can decode as a space.

cURL

curl --get "https://api.vobiz.ai/api/v1/Account/{auth_id}/numbers" \
  --data-urlencode "page=1" \
  --data-urlencode "per_page=20" \
  --data-urlencode "search=+919876543210" \
  -H "X-Auth-ID: {auth_id}" \
  -H "X-Auth-Token: {auth_token}"

Response Example

Success Response (200 OK)

{
  "items": [
    {
      "id": "aabbccdd-1234-5678-90ab-cdef12345678",
      "account_id": "MA_XXXXXXXX",
      "e164": "+919876543210",
      "country": "IN",
      "region": "Karnataka",
      "capabilities": {
        "voice": true,
        "sms": false,
        "mms": false,
        "fax": false
      },
      "status": "active",
      "provider": "",
      "setup_fee": 100,
      "monthly_fee": 300,
      "currency": "INR",
      "application_id": "20577609616603585",
      "voice_enabled": true,
      "tags": [],
      "purchased_at": "2026-03-25T06:58:38.796024Z",
      "is_blocked": false,
      "created_at": "2026-03-25T18:30:00Z",
      "updated_at": "2026-03-25T06:58:54.752187Z",
      "is_trial_number": false,
      "last_billing_date": "2026-03-25T06:58:38.796024Z",
      "next_billing_date": "2026-04-25T06:58:38.796024Z",
      "minimum_commitment_months": 0,
      "aadhaar_verification_required": false,
      "aadhaar_verified": false,
      "source": "purchased"
    }
  ],
  "page": 1,
  "per_page": 25,
  "total": 24
}

Response Structure:

items: Array of phone number objects purchased by your account
page: Current page number
per_page: Number of items per page
total: Total count of purchased phone numbers

Only phone numbers owned by an account (with a populated account_id) are returned. Numbers still in inventory (auth_id=NULL) are not included - browse those with List Inventory Numbers.

Authorizations

X-Auth-ID

string

header

required

Your Vobiz account Auth ID

X-Auth-Token

string

header

required

Your Vobiz account Auth Token

Path Parameters

auth_id

string

required

Your account Auth ID

Example:

"MA_XXXXXX"

Query Parameters

page

integer

default:1

Page number, starting at 1

Required range: x >= 1

per_page

integer

default:25

Number of phone numbers to return per page

Required range: x >= 1

string

Filter by phone number. Include the country code and URL-encode a leading plus sign.

Example:

"+919876543210"

Response

200 - application/json

List of phone numbers

items

object[]

required

Show child attributes

page

integer

required

per_page

integer

required

total

integer

required

⌘I

List phone numbers

curl --request GET \
  --url https://api.vobiz.ai/api/v1/Account/{auth_id}/numbers \
  --header 'X-Auth-ID: <api-key>' \
  --header 'X-Auth-Token: <api-key>'

import requests

url = "https://api.vobiz.ai/api/v1/Account/{auth_id}/numbers"

headers = {
    "X-Auth-ID": "<api-key>",
    "X-Auth-Token": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};

fetch('https://api.vobiz.ai/api/v1/Account/{auth_id}/numbers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "items": [
    {
      "id": "aabbccdd-1234-5678-90ab-cdef12345678",
      "account_id": "MA_XXXXXXXX",
      "e164": "+919876543210",
      "country": "IN",
      "region": "Karnataka",
      "capabilities": {
        "voice": true,
        "sms": false,
        "mms": false,
        "fax": false
      },
      "status": "active",
      "provider": "",
      "setup_fee": 100,
      "monthly_fee": 300,
      "currency": "INR",
      "application_id": "20577609616603585",
      "voice_enabled": true,
      "tags": [],
      "purchased_at": "2026-03-25T06:58:38.796024Z",
      "is_blocked": false,
      "created_at": "2026-03-25T18:30:00Z",
      "updated_at": "2026-03-25T06:58:54.752187Z",
      "is_trial_number": false,
      "last_billing_date": "2026-03-25T06:58:38.796024Z",
      "next_billing_date": "2026-04-25T06:58:38.796024Z",
      "minimum_commitment_months": 0,
      "aadhaar_verification_required": false,
      "aadhaar_verified": false,
      "source": "purchased"
    },
    {
      "id": "11223344-5566-7788-99aa-bbccddeeff00",
      "account_id": "MA_XXXXXXXX",
      "e164": "+912271263984",
      "country": "IN",
      "region": "Mumbai",
      "capabilities": {
        "voice": true,
        "sms": false,
        "mms": false,
        "fax": false
      },
      "status": "active",
      "provider": "",
      "setup_fee": 100,
      "monthly_fee": 200,
      "currency": "INR",
      "application_id": "31985999331899218",
      "voice_enabled": true,
      "tags": [],
      "purchased_at": "2026-03-25T10:25:30.672202Z",
      "is_blocked": false,
      "created_at": "2026-03-25T09:30:04.541115Z",
      "updated_at": "2026-03-25T10:29:35.330503Z",
      "is_trial_number": false,
      "last_billing_date": "2026-03-25T10:25:30.672202Z",
      "next_billing_date": "2026-04-25T10:25:30.672202Z",
      "minimum_commitment_months": 0,
      "aadhaar_verification_required": false,
      "aadhaar_verified": false,
      "source": "purchased"
    }
  ],
  "page": 1,
  "per_page": 25,
  "total": 24
}

​Query Parameters

​Request

​Search owned numbers

​Response Example

Authorizations

Path Parameters

Query Parameters

Response

Query Parameters

Request

Search owned numbers

Response Example