Phone Numbers

Manage phone numbers for outbound calling

List phone numbers

get

List all phone numbers configured in your account. These numbers can be used for outbound calling by referencing their ID.

Authorizations

ApiKeyAuth

X-API-KeystringRequired

API key for authentication

Query parameters

pageinteger · min: 1Optional

Page number for pagination

Default: 1

limitinteger · min: 1 · max: 100Optional

Number of items per page

Default: 20

agentIdstringOptional

Filter by agent ID

statusstring · enumOptional

Filter by assignment status

Possible values:

Responses

200

Successful response

application/json

get

/numbers

HTTPcURLJavaScriptPython

GET /api/v1/numbers HTTP/1.1
Host: api.omnia-voice.com
X-API-Key: YOUR_API_KEY
Accept: */*

200

Successful response

{
  "data": [
    {
      "id": "text",
      "phoneNumber": "text",
      "friendlyName": "text",
      "agentId": "text",
      "agent": {
        "id": "text",
        "name": "text",
        "status": "ACTIVE"
      },
      "provider": "twilio",
      "capabilities": {
        "voice": true,
        "sms": true
      },
      "status": "active",
      "createdAt": "2025-12-13T09:37:40.813Z",
      "updatedAt": "2025-12-13T09:37:40.813Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 1,
    "total": 1,
    "totalPages": 1
  }
}

Get phone number details

get

Get details of a specific phone number

Authorizations

ApiKeyAuth

X-API-KeystringRequired

API key for authentication

Path parameters

idstringRequired

Phone number ID

Responses

200

Successful response

application/json

404

Phone number not found

application/json

get

/numbers/{id}

HTTPcURLJavaScriptPython

GET /api/v1/numbers/{id} HTTP/1.1
Host: api.omnia-voice.com
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "id": "text",
  "phoneNumber": "text",
  "friendlyName": "text",
  "agentId": "text",
  "agent": {
    "id": "text",
    "name": "text",
    "status": "ACTIVE"
  },
  "provider": "twilio",
  "capabilities": {
    "voice": true,
    "sms": true
  },
  "status": "active",
  "createdAt": "2025-12-13T09:37:40.813Z",
  "updatedAt": "2025-12-13T09:37:40.813Z"
}