International Phone Number Format API Documentation
International Phone Number Validation and Correction API
Category: Web Tools
Endpoint: GET https://api.gugudata.io/v1/websitetools/international-phone-format
Description: Validity check and intelligent correction of international phone numbers.
Overview
The International Phone Number Validation and Correction API by GuGuData enables E.164-compliant checks and intelligent reformatting of international mobile numbers. Whether you're verifying user inputs or standardizing phone number databases, this API swiftly determines validity and outputs a unified format—all while adhering to recognized industry standards.
Key highlights:
- E.164 compliance – Ensures numbers meet global phone standards.
- Intelligent correction – Automatically fixes common formatting issues.
- Millisecond-level response – Suitable for high-volume use cases.
- Multi-node CDN – Low-latency responses, globally distributed.
Demo URL
https://api.gugudata.io/v1/websitetools/international-phone-format/demo
Request Parameters
Send a GET request to the endpoint with the following query parameters:
| Parameter | Type | Required | Default Value | Description |
appkey | string | Yes | APPKEY | Your APPKEY obtained from GuGuData's Developer Center. |
phone | string | Yes | PHONE | The phone number to validate or correct (e.g., +1(817) 569-8900). |
Response Parameters
A successful request returns a JSON object with validation info and standardized phone number data. Below are the main fields:
| Parameter | Type | Required | Description |
dataStatus.requestParameter | string | Yes | The requested parameters (i.e., phone). |
dataStatus.statusCode | int | Yes | HTTP status code (e.g., 200). |
dataStatus.status | string | Yes | The request status (e.g., SUCCESS, ERROR). |
dataStatus.statusDescription | string | Yes | A short description of the request status. |
dataStatus.responseDateTime | string | Yes | The timestamp when the data was returned. |
dataStatus.dataTotalCount | int | Yes | The total number of returned records (often 1 for phone validations). |
data.isValid | boolean | Yes | Indicates if the phone number passes validation. |
data.correctedMobileNumber | string | Yes | If valid, the unified international version of the phone number. |
data.countryCode | string | Yes | The country dial code (e.g., +1 for the USA). |
data.countryCode2 | string | Yes | The ISO-3166 two-letter country code (e.g., US). |
data.countryCode3 | string | Yes | The ISO-3166 three-letter country code (e.g., USA). |
Error Codes
Below are typical error codes you might encounter:
| Error Code | Error Content | Notes |
200 | SUCCESS | Request completed successfully. |
400 | Parameter Error | Possibly invalid or missing parameters (e.g., no phone). |
401 | Unauthorized | Invalid or missing APPKEY. |
429 | Too Many Requests | Exceeded rate limit; slow down requests or implement back-off. |
500 | Internal Server Error | A generic server-side error; try again or contact support. |
Features
- Detect validity of international phone numbers in compliance with the E.164 standard.
- Determine whether the provided number is correct for its respective country.
- Auto-correct input into a unified format—useful for SMS sending and consistent databases.
- Millisecond response ensures minimal latency in high-volume scenarios.
- HTTPS (TLS v1.0–v1.3) – Secure data transfer.
- Apple ATS-compatible – Ideal for iOS/macOS apps.
- Nationwide multi-node CDN – Fast responses across various regions.
- Load-balanced infrastructure – Built for reliability and scale.
Additional Notes for Developers
- Input flexibility: The API handles various input styles, including parentheses, dashes, and spaces.
- Exactness: For highly accurate results, ensure you pass the correct country dial code (if known).
- Scalability: High concurrency is supported, but keep rate limits in mind (
429if exceeded).
Getting Started
- Sign up at GuGuData.io – Obtain your APPKEY.
- Construct a GET request – Pass your
appkeyand the targetphonenumber as query parameters. - Inspect the JSON response – Evaluate
isValidand retrieve the corrected phone format if valid. - Integrate – Use the standardized format for CRM systems, messaging services, or user data cleanup.
About GuGuData
GuGuData delivers robust data-driven services, from DNS Lookups to SSL Certificate Parsing. We refine vast amounts of information via advanced pipelines, guaranteeing reliability and speed for businesses, researchers, and developers.
Key Highlights:
- Nine years in business – An established track record of API expertise.
- 4.2k+ APIs – Continually expanding data and functionality coverage.
- 95% happy customers – Trusted for accuracy and performance.
Leverage the International Phone Number Validation and Correction API to streamline contact data management and ensure compliance with international communication standards. Visit our official website for more solutions from GuGuData.