List your numbers

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

from vobiz import Vobiz

client = Vobiz(api_key="MA_XXXXXXXX", auth_token="YOUR_AUTH_TOKEN")

client.sms.numbers.list_numbers()

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

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

{
  "numbers": [
    {
      "e164": "+14155550100",
      "provider": "internal",
      "countryCode": "US",
      "channels": [
        "sms",
        "mms"
      ],
      "type": "VIRTUAL_LONG_NUMBER",
      "capabilities": [
        "SMS",
        "VOICE",
        "MMS"
      ],
      "tenDlc": {
        "campaignId": "3f1c7a2e-9d4b-4e8a-b6c5-2a7d9e1f0b43",
        "campaignName": "Order notifications",
        "stage": "REGISTERED"
      },
      "tollFree": false,
      "registration": {
        "kind": "10dlc",
        "status": "approved",
        "campaignId": "3f1c7a2e-9d4b-4e8a-b6c5-2a7d9e1f0b43",
        "campaignName": "Order notifications",
        "stage": "REGISTERED"
      },
      "lastMessage": {
        "status": "delivered",
        "errorCode": "",
        "errorMessage": "",
        "to": "+14155550123",
        "createdAt": "2026-10-16T21:23:02Z"
      },
      "sendable": {
        "international": true,
        "usDomestic": true
      }
    },
    {
      "e164": "+14155550101",
      "provider": "internal",
      "countryCode": "US",
      "channels": [
        "sms",
        "mms"
      ],
      "type": "VIRTUAL_LONG_NUMBER",
      "capabilities": [
        "SMS",
        "VOICE",
        "MMS"
      ],
      "tenDlc": null,
      "tollFree": false,
      "registration": {
        "kind": "10dlc",
        "status": "not_registered",
        "campaignId": "",
        "campaignName": "",
        "stage": ""
      },
      "lastMessage": null,
      "sendable": {
        "international": true,
        "usDomestic": false
      }
    }
  ]
}

{
  "error": "missing or invalid credentials"
}

{
  "error": "internal error"
}