Format International Phone

International Phone Number Validation and Correction
Validity check and intelligent correction

Method: GET
Path: /v1/websitetools/international-phone-format
Demo: https://api.gugudata.io/v1/websitetools/international-phone-format/demo

Request Parameters:

appkey (string, required): APPKEY obtained after purchase

phone (string, required): The mobile number to query, e.g., +1(817) 569-8900

Response Fields Count: 11
Response Field Examples:

dataStatus.requestParameter: Request parameters

dataStatus.statusCode: API response status code

dataStatus.status: Status

dataStatus.statusDescription: Status description

dataStatus.responseDateTime: API response time

dataStatus.dataTotalCount: Total data count, generally used for pagination

data.isValid: Whether the mobile number is valid

data.correctedMobileNumber: Corrected mobile number

... total 11 fields

Key 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)

Details:
https://gugudata.io/details/international-phone-format

Responses

⚪0

application/json

Body

Example

{
  "dataStatus": {
    "requestParameter": "string",
    "statusCode": 0,
    "status": "string",
    "statusDescription": "string",
    "responseDateTime": "string",
    "dataTotalCount": 0
  },
  "data": {
    "isValid": false,
    "correctedMobileNumber": "string",
    "countryCode": "string",
    "countryCode2": "string",
    "countryCode3": "string"
  },
  "DataStatus": {
    "StatusCode": 100,
    "StatusDescription": "OK",
    "ResponseDateTime": "2026-01-01 00:00:00",
    "DataTotalCount": 1
  }
}

Request

Request Code Samples

Responses