> ## Documentation Index > Fetch the complete documentation index at: https://docs.wavix.com/llms.txt > Use this file to discover all available pages before exploring further. # Validate multiple numbers > Validates a batch of phone numbers. When `async` is `true`, returns a `request_id` to poll for results instead of the validation details. ## OpenAPI ````yaml https://wavix.github.io/wavix-openapi/wavix-api.yaml post /v1/validation openapi: 3.1.0 info: title: Wavix APIs description: >- Wavix provides robust APIs that let you integrate voice and text messaging features directly into your app. Send text, place calls, and access detailed reports programmatically. termsOfService: https://wavix.com/terms-and-conditions license: name: MIT identifier: MIT contact: name: Wavix url: https://wavix.com email: support@wavix.com version: '1.0' servers: - url: https://api.wavix.com description: https://api.wavix.com variables: {} security: - bearerAuth: [] tags: - name: SIP trunks description: SIP trunks - name: Buy description: Numbers - name: Cart description: Numbers - name: My numbers description: Numbers - name: Billing description: Billing, transactions, and invoices - name: Profile description: Account profile and customer information - name: CDRs description: Call detail records and call history - name: Speech Analytics description: Call transcription and speech analytics - name: SMS and MMS description: Messaging - name: Number Validator description: Phone number validation - name: Link shortener description: Short link and click metrics - name: 2FA description: Two-factor authentication - name: 10DLC description: 10DLC Campaigns and Brands - name: API Keys description: API key management - name: Call webhooks description: Webhook configuration for call events - name: Call control description: Programmable Voice - name: Call streaming description: Real-time call audio streaming over WebSocket - name: Call recording description: Call recording - name: Sub-accounts description: Sub-account management - name: Voice campaigns description: Outbound voice campaigns - name: Wavix Embeddable description: WebRTC embeddable widget paths: /v1/validation: post: tags: - Number validator summary: Validate multiple numbers description: >- Validates a batch of phone numbers. When `async` is `true`, returns a `request_id` to poll for results instead of the validation details. operationId: number_validator_create_bulk parameters: [] requestBody: description: Phone numbers to validate and validation options. content: application/json: schema: allOf: - $ref: '#/components/schemas/PhoneValidationRequest' required: true responses: '200': description: >- Returns the validation results, or a `request_id` when validation is asynchronous. headers: {} content: application/json: schema: $ref: '#/components/schemas/NumberValidatorCreateBulkResponse' examples: success: summary: Successful response value: status: success pending: 0 count: 1000 items: - phone_number: '971569483322' valid: true country_code: AE e164_format: '+971569483322' national_format: 056 948 3322 ported: false mcc: '424' mnc: '004' number_type: mobile carrier_name: Etisalat risky_destination: false unallocated_range: false reachable: true roaming: false timezone: UTC+04:00 charge: '0.015' error_code: '000' '400': $ref: '#/components/responses/BadRequestErrorResponse' '403': $ref: '#/components/responses/ForbiddenErrorResponse' '404': $ref: '#/components/responses/NotFoundErrorResponse' deprecated: false security: - bearerAuth: - validator:write components: schemas: PhoneValidationRequest: title: PhoneValidationRequest required: - phone_numbers - type - async - force type: object additionalProperties: false properties: phone_numbers: type: array items: type: string description: List of phone numbers to get detailed information about. example: - '971501390098' - '971504359195' type: $ref: '#/components/schemas/PhoneNumberValidationType' async: type: boolean description: >- 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: type: boolean description: >- Indicates whether to force a fresh validation instead of returning a previously cached result. example: true NumberValidatorCreateBulkResponse: anyOf: - $ref: '#/components/schemas/PhoneValidationBatchResponse' - type: object title: Async Request description: >- Returned when validation runs asynchronously; poll results using `request_id`. properties: request_id: type: string description: >- Request ID. Use to poll validation results when `async` is `true`. example: 15323ba4-80c1-41be-b8e7-07bb435c7445 PhoneNumberValidationType: title: PhoneNumberValidationType enum: - format - analysis - validation type: string description: >- 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). PhoneValidationBatchResponse: title: PhoneValidationBatchResponse required: - count - items - status - pending type: object additionalProperties: false properties: status: type: string description: Validation request status. example: success pending: type: integer description: Number of validations still in progress. example: 0 count: type: integer format: int32 description: Total number of phone numbers in the request. example: 1000 items: type: array items: $ref: '#/components/schemas/PhoneValidationResultResponse' description: List of validation results for each phone number. ValidationErrorResponse: title: ValidationErrorResponse type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false message: type: string description: >- Human-readable description naming the missing or invalid request parameter. example: Missing or invalid parameter ForbiddenErrorResponse: title: ForbiddenErrorResponse type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false message: type: string description: Human-readable description of why access is forbidden. example: The service is not provisioned for your account. NotFoundErrorResponse: title: NotFoundErrorResponse type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false message: type: string description: >- Human-readable description stating that no resource matches the given ID. example: Record not found PhoneValidationResultResponse: title: PhoneValidationResultResponse required: - phone_number - valid - country_code - e164_format - national_format - charge - error_code type: object additionalProperties: false properties: phone_number: type: string description: Phone number. example: '971569483322' valid: type: boolean description: Indicates whether the phone number is valid. example: true country_code: type: - string - 'null' description: >- Phone number country code in ISO 3166-1 alpha-2 format. `null` if the number is invalid. example: AE e164_format: type: string description: Phone number in international E.164 format. example: '+971569483322' national_format: type: string description: Phone number in the national format of the identified country. example: 056 948 3322 ported: type: - boolean - 'null' description: >- Indicates whether the phone number is ported. `null` if the phone number is invalid. example: false mcc: type: - string - 'null' description: >- Mobile Country Code (MCC). Applies to mobile numbers only. `null` if the phone number is invalid. example: '424' mnc: type: - string - 'null' description: >- Mobile Network Code (MNC). Applies to mobile numbers only. `null` if the phone number is invalid. example: '004' number_type: type: - string - 'null' description: >- Phone number type. Allowed values: `mobile`, `landline`, `toll-free`. `null` if the phone number is invalid. example: mobile carrier_name: type: - string - 'null' description: Carrier name. `null` if the phone number is invalid. example: Etisalat risky_destination: type: - boolean - 'null' description: >- Indicates whether the phone number belongs to a range associated with traffic pumping. `null` if the phone number is invalid. example: false unallocated_range: type: - boolean - 'null' description: |- Indicates whether the phone number belongs to an unallocated range. `null` if the phone number is invalid. example: false reachable: type: - boolean - 'null' description: >- Indicates whether the number is registered in a mobile network. Applies to mobile numbers only. `null` if the phone number is invalid. example: true roaming: type: - boolean - 'null' description: >- Indicates whether the number is roaming. Applies to mobile numbers only. `null` if the phone number is invalid. example: false timezone: type: - string - 'null' description: >- Time zone identified based on the country and area code. `null` if the phone number is invalid. example: UTC+04:00 charge: type: string description: Charge for the validation. example: '0.015' error_code: type: string description: >- Result code for the validation. `000` indicates success. Possible values: - `013` — internal service error, uncategorized. - `021` — invalid phone number length or format. - `041` — remote timeout. - `042` — remote query failed. - `091` — insufficient funds. example: '000' description: Number validator response details. responses: BadRequestErrorResponse: description: Request failed. Missing or invalid parameter headers: {} content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' ForbiddenErrorResponse: description: Request failed. The feature is disabled for your account. headers: {} content: application/json: schema: $ref: '#/components/schemas/ForbiddenErrorResponse' NotFoundErrorResponse: description: Request failed. An object with the specified ID is not found. headers: {} content: application/json: schema: $ref: '#/components/schemas/NotFoundErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer description: > Wavix API key. Pass as `Authorization: Bearer `. Keys support per-resource scopes (none / read / write). See [Restricted keys and scopes](https://docs.wavix.com/api-reference/authentication#restricted-keys-and-scopes). ````