# 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](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](https://gugudata.io/) 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](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

1. **Detect validity** of international phone numbers in compliance with the E.164 standard.
2. **Determine** whether the provided number is correct for its respective country.
3. **Auto-correct** input into a unified format—useful for SMS sending and consistent databases.
4. **Millisecond response** ensures minimal latency in high-volume scenarios.
5. **HTTPS (TLS v1.0–v1.3)** – Secure data transfer.
6. **Apple ATS-compatible** – Ideal for iOS/macOS apps.
7. **Nationwide multi-node CDN** – Fast responses across various regions.
8. **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 (`429` if exceeded).

## Getting Started

1. **Sign up at [GuGuData.io](https://gugudata.io/)** – Obtain your APPKEY.
2. **Construct a GET request** – Pass your `appkey` and the target `phone` number as query parameters.
3. **Inspect the JSON response** – Evaluate `isValid` and retrieve the corrected phone format if valid.
4. **Integrate** – Use the standardized format for CRM systems, messaging services, or user data cleanup.

## About GuGuData

[**GuGuData**](https://gugudata.io/) delivers robust **data-driven** services, from [DNS Lookups](https://gugudata.io/) to [SSL Certificate Parsing](https://gugudata.io/). 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](https://gugudata.io/) for more solutions from GuGuData.