WAwavix
Number validator

Validate multiple numbers

Changed on

Validates a batch of phone numbers. When async is true, returns a request_id to poll for results instead of the validation details.

post/v1/validation

Request

  • Base URL
    https://api.wavix.com
  • URL
    https://api.wavix.com/v1/validation
  • Auth
    HTTP bearer

Request body

phone_numbersstring[] required

List of phone numbers to get detailed information about. Maximum 1000 numbers per request.

type'format' | 'analysis' | 'validation' required

Depth of validation to perform on the phone number. One of format (checks number syntax only), analysis (returns number metadata such as type and country), or validation (performs a live network lookup of the number's current status).

asyncboolean

Indicates whether the request should be executed asynchronously. If true, the response will include a request_uuid that can be used to poll for results. If false (default), the response will include validation results directly.

forceboolean

Indicates whether to force a fresh validation instead of returning a previously cached result. Defaults to false.

Example request

{
  "phone_numbers": [
    "971501390098",
    "971504359195"
  ],
  "async": true,
  "force": true
}

Response

Returns the validation results, or a request_id when validation is asynchronous.

OR

Example response

{
  "status": "success",
  "count": 1000,
  "items": [
    {
      "phone_number": "971569483322",
      "valid": true,
      "country_code": "AE",
      "e164_format": "+971569483322",
      "national_format": "056 948 3322",
      "mcc": "424",
      "mnc": "004",
      "number_type": "mobile",
      "carrier_name": "Etisalat",
      "reachable": true,
      "timezone": "UTC+04:00",
      "charge": "0.015",
      "error_code": "000"
    }
  ]
}

Changes

  • d4db3aae3627Revision changes
    • breaking

      the request's body type changed from no type to object

  • 6a89c962481cRevision changes
    • info

      the request property / became optional

    • info

      the request property / became optional

    • info

      the request property default value false was added

    • info

      the request property default value false was added

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status