Skip to main content
GET
/
api
/
v1
/
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>'
{
  "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

FieldTypeRequiredDescription
limitintegerNoMaximum number of records to return. Default: 20.
offsetintegerNoNumber of records to skip for pagination. Default: 0.
The response is reported with page, per_page, and total counters, while the request paginates with limit and offset.
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 -X GET "https://api.vobiz.ai/api/v1/Account/{auth_id}/numbers" \
  -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

​
limit
integer
default:20
​
offset
integer
default:0

Response

200 - application/json

List of phone numbers

​
items
object[]
required
​
page
integer
required
​
per_page
integer
required
​
total
integer
required