---
title: "Validate a phone number"
method: POST
path: "/phonevalidation"
tags: ["Phone"]
---

# Validate a phone number

`POST /phonevalidation`

## Request

- Base URL: `https://lookup.proweblook.com/api/v1`
- URL: `https://lookup.proweblook.com/api/v1/phonevalidation`
- Auth: none required

Validate and enrich one phone number using a JSON or form body. api_key and phone_number are required in the body. When country_code is omitted or set to none, send a full international number including its country calling code, preferably in E.164 form. A local or national number requires country_code. One credit is deducted from phoneapi_balance per successful validation. The empty OpenAPI security override does not mean this operation accepts unauthenticated requests; OpenAPI 3.0 cannot represent an API key located in a request body.

## Request body

- object
  - `phone_number` string, required: Phone number to validate. When country_code is omitted or set to none, send the complete international number, preferably in E.164 form, including the leading + and country calling code (for example, +14155552671). A local or national number requires country_code (for example, phone_number=9876543210 with country_code=IN). Percent-encode a leading + as %2B in a GET URL.
  - `country_code` string: Optional ISO 3166-1 alpha-2 country hint such as US, IN, or GB. This is a country identifier, not a numeric calling prefix such as +1 or +91. Omit it, or use the literal value none, only with a complete international phone_number.
  - `api_key` string, password, required: Your ProWebLook API key.

## Response `200`

Validation completed. INVALID is a completed validation result returned with HTTP 200, not an API error.

- PhoneValidationResponse: A completed phone-validation result. INVALID is a normal result and may contain only status; enrichment fields are not guaranteed for an invalid number.
  - `status` 'VALID_CONFIRMED' | 'INVALID', required: VALID_CONFIRMED for a confirmed number or INVALID when the supplied number could not be validated.
  - `formatted_number` string: Internationally formatted number returned by the API.
  - `linetype` 'Mobile' | 'Fixed Line' | 'Fixed Line or Mobile' | 'Toll-Free' | 'Premium Rate' | 'Shared Cost' | 'VoIP' | 'Personal Number' | 'Pager' | 'Universal Access Number' | 'Voicemail' | 'Unknown'
  - `carrier` string: Carrier/operator name. May be an empty string for landlines.
  - `location` string: Geographic description such as a city, region, or country.
  - `countrycodenum` integer: Numeric country calling code.
  - `countrycode` string: ISO 3166-1 alpha-2 country code.
  - `countryname` string: Full country name.
  - `formatnational` string: Phone number in national display format.
  - `formatinternational` string: Phone number in international display format.
  - `timezone` string[]: Applicable IANA timezone identifiers.
  - `ratelimit_remain` integer: Calls remaining in the current rate-limit window.
  - `ratelimit_seconds` integer: Seconds until the current rate-limit window resets.

## Other responses

- `400`: A required parameter is missing or a parameter is invalid.
- `401`: The API key is missing or invalid.
- `402`: The account has insufficient phone-validation credits.
- `500`: An unexpected server error occurred.

---

[API](https://skmtc.dev/proweblook/apis/proweblook-api.md) · [All operations](https://skmtc.dev/proweblook/apis/proweblook-api/llms.txt) · [OpenAPI document](https://skmtc.dev/proweblook/apis/proweblook-api/revisions/b15b4101aa8e?raw)