Skip to main content
GET
/
v2
/
api
/
numbers
List phone numbers
curl --request GET \
  --url https://api.withallo.com/v2/api/numbers \
  --header 'Authorization: <api-key>'
{
  "data": [
    {
      "number": "+14155550100",
      "name": "Sales US",
      "country": "US",
      "type": "NUMBER",
      "capabilities": [
        "VOICE",
        "SMS",
        "MMS"
      ],
      "users": [
        {
          "id": "usr-abc123",
          "name": "Adrien",
          "email": "[email protected]"
        }
      ]
    },
    {
      "number": "+33612345678",
      "name": "Support FR",
      "country": "FR",
      "type": "NUMBER",
      "capabilities": [
        "VOICE"
      ],
      "users": [
        {
          "id": "usr-abc123",
          "name": "Adrien",
          "email": "[email protected]"
        },
        {
          "id": "usr-def456",
          "name": "Marie",
          "email": "[email protected]"
        }
      ]
    },
    {
      "number": null,
      "name": "Acme Corp",
      "country": "FR",
      "type": "SENDER_ID",
      "capabilities": [
        "SMS"
      ],
      "users": []
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://help.withallo.com/llms.txt

Use this file to discover all available pages before exploring further.

Required scope: PHONE_NUMBERS_READ
Returns all phone numbers and sender IDs in a single response. This endpoint is not paginated.

Authorizations

​
Authorization
string
header
required

Response

List of phone numbers

​
data
object[]