Bestseller
Complies with E.164 standard Intelligent Unified Format
International Phone Number Validation and Correction
Validity check and intelligent correction
Data & API Features
Intelligently detect the validity of international mobile numbers;
Determine whether the provided mobile number is valid in a specific country based on the provided country code parameter;
Intelligently correct the provided mobile number format into a unified international format for consistent use in scenarios such as sending SMS messages;
Millisecond-level response performance;
Full API supports HTTPS (TLS v1.0 / v1.1 / v1.2 / v1.3);
Fully compatible with Apple ATS;
Nationwide multi-node CDN deployment;
Ultra-fast API response with load balancing across multiple servers.
Annual Subscription
$19$49
Try it for free!
Sign In Sign in to get a trial key and test all APIs.
Secure payment by Stripe
API Document
HTTP Protocol:HTTPS
HTTP Method:GET
HTTP Endpoint:https://api.gugudata.io/v1/websitetools/international-phone-format
Response Type:application/json; charset=utf-8
DEMO Endpoint:https://api.gugudata.io/v1/websitetools/international-phone-format/demo
Live Demo:Try Interactive Demo
Full API Docs:developers.gugudata.io
API Request Parameters
| Name | Type | Is Required | Default Value | Remark |
|---|---|---|---|---|
| appkey | string | true | APPKEY | APPKEY obtained after purchase |
| phone | string | true | PHONE | The mobile number to query, e.g., +1(817) 569-8900 |
API Response Parameters
| Name | Type | Remark |
|---|---|---|
| dataStatus.requestParameter | string | Request parameters |
| dataStatus.statusCode | int | API response status code |
| dataStatus.status | string | Status |
| dataStatus.statusDescription | string | Status description |
| dataStatus.responseDateTime | string | API response time |
| dataStatus.dataTotalCount | int | Total data count, generally used for pagination |
| data.isValid | boolean | Whether the mobile number is valid |
| data.correctedMobileNumber | string | Corrected mobile number |
| data.countryCode | string | Country phone prefix, e.g., +1 |
| data.countryCode2 | string | ISO-3166 two-letter country code |
| data.countryCode3 | string | ISO-3166 three-letter country code |
API Response Status Codes
| Status Code | Explanation of Status Code | Remarks |
|---|---|---|
| 200 | API responding normally | For business status codes, see below under API Custom Status Codes. |
| 400 | Parameter error | |
| 402 | APPKEY error | Please check if the APPKEY provided is the one obtained from the developer center. |
| 403 | Account overdue | Please pay attention to the E-mail reminders regarding order expiration. |
| 429 | Request rate limited | Requests cannot exceed 5 times per second. The CDN layer intelligently determines based on the frequency of IP requests. General high-frequency requests do not trigger this status code. |
| 500 | API response error |
