WAwavix
Buy

List available phone numbers

Changed on

Returns a paginated list of phone numbers available for purchase in the specified city.

get/v1/buy/countries/{country_id}/cities/{city_id}/dids

Request

  • Base URL
    https://api.wavix.com
  • URL
    https://api.wavix.com/v1/buy/countries/{country_id}/cities/{city_id}/dids
  • Auth
    HTTP bearer

Path parameters

country_idinteger required

The unique ID of the country.

city_idinteger required

The unique ID of the city.

Query parameters

text_enabled_onlyboolean

When true, returns only text-enabled phone numbers.

pageinteger

Page number to retrieve. Default 1.

per_pageinteger

Number of records to return per page. Default 25.

Response

Returns a paginated list of available phone numbers.

Example response

{
  "dids": [
    {
      "id": 541139862174,
      "activation_fee": "15.0",
      "monthly_fee": "10.0",
      "per_min": "0.01",
      "channels": "4",
      "city": "Buenos Aires",
      "country": "Argentina",
      "country_short_name": "AR",
      "number": "541139862174",
      "require_docs": [
        "address"
      ],
      "domestic_cli": true
    }
  ],
  "pagination": {
    "current_page": 2,
    "per_page": 25,
    "total": 101,
    "total_pages": 5
  }
}

Changes

  • 76b9ec29392aRevision changes
    • breaking

      the /// response's property type changed from integer to string, and format from int32 to no format for status

    • warning

      added the new address enum value to the /// response property for the response status

    • warning

      added the new id enum value to the /// response property for the response status

    • warning

      added the new localaddress enum value to the /// response property for the response status

  • 6a89c962481cRevision changes
    • breaking

      the response's body type changed from no type to object for status

    • info

      removed subschema #2 from the response body allOf list for the response status

    • info

      added the non-success response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status