v50

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-06-16122182589.7 KB
My numbers

List phone numbers

Returns a paginated list of the phone numbers owned by the authenticated account.

get/v1/numbers

Query parameters

city_idinteger
Example:123

Filters numbers by the ID of their city or rate center.

searchstring
Example:256537

Filters numbers by a full or partial phone number.

labelstring
Example:ALEX

Filters numbers by label.

label_presentboolean
Example:true

When true, returns only numbers that have a label; when false, only numbers without one.

pageinteger
Example:2

Page number to retrieve. Default 1.

per_pageinteger
Example:50

Number of records to return per page. Default 25.

Response

Returns a paginated list of phone numbers.

Example response

{
  "items": [
    {
      "id": 123,
      "number": "12565378257",
      "activation_fee": "0.99",
      "monthly_fee": "0.99",
      "per_min": "0.01",
      "city": "DETROIT, MI",
      "country": "United States",
      "country_short_name": "US",
      "destination": [
        {
          "id": 1,
          "destination": "[did]@sipuri.com",
          "priority": 1,
          "trunk_id": 23123,
          "trunk_label": "My trunk"
        }
      ],
      "channels": 24,
      "require_docs": [
        "1"
      ],
      "documents": [
        {
          "id": 423,
          "allow_replace": false,
          "did_number": "12565378257",
          "doc_content_type": "image/png",
          "doc_file_name": "Copy of ID.png",
          "doc_type_id": 1,
          "status": "approved",
          "url": "https://api.wavix.com/v1/numbers/24882/papers/1"
        }
      ],
      "added": "2023-04-10T06:42:59.000Z",
      "paid_until": "2023-12-07",
      "sms_relay_url": "https://your-website.com/webhook",
      "cnam": true,
      "call_recording_enabled": true,
      "transcription_enabled": true,
      "transcription_threshold": 6,
      "call_status_url": "https://example.com"
    }
  ],
  "doc_types": [
    {
      "id": 2,
      "name": "address",
      "title": "Proof of address"
    }
  ],
  "pagination": {
    "current_page": 2,
    "per_page": 25,
    "total": 101,
    "total_pages": 5
  }
}