Skip to main content
POST
Validate multiple numbers

Authorizations

Authorization
string
header
required

Wavix API key. Pass as Authorization: Bearer <api_key>. Keys support per-resource scopes (none / read / write). See Restricted keys and scopes.

Body

application/json

Phone numbers to validate and validation options.

phone_numbers
string[]
required

List of phone numbers to get detailed information about.

Example:
type
enum<string>
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).

Available options:
format,
analysis,
validation
async
boolean
required

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, the response will include validation results directly.

Example:

true

force
boolean
required

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

Example:

true

Response

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

status
string
required

Validation request status.

Example:

"success"

pending
integer
required

Number of validations still in progress.

Example:

0

count
integer<int32>
required

Total number of phone numbers in the request.

Example:

1000

items
PhoneValidationResultResponse · object[]
required

List of validation results for each phone number.