Phone Number Formatter

Parse and format a phone number into E.164, national, and international formats

GET


                    api/v1/format-phone

Parse and format a phone number into E.164, national, and international formats

Rate Limiting

Standard rate limits apply to this endpoint.

Authentication

This endpoint requires authentication via API key. You can use the sandbox mode for testing without registering. See the authentication guide for details.

Query Parameters

Parameter	Type	Required	Description
`phone`	string	Required	The phone parameter
`country_code`	string	Required	The country_code parameter

Response details for this API endpoint. See the response format guide for the standard response structure.

Example Response

{
    "status": "success",
    "http_code": 200,
    "code": "SUCCESS",
    "message": "Phone number formatted successfully",
    "data": {
        "original": "+1 (212) 555-1234",
        "e164": "+12125551234",
        "national": "(212) 555-1234",
        "international": "+1 212 555 1234",
        "country_code": "US",
        "country_name": "United States",
        "is_valid": true,
        "validated_at": "2025-05-19T12:00:00+00:00"
    }
}

Example Usage

Here's how to use this endpoint in various languages. For more examples, see our code examples page.

cURL

curl -X GET \
    "https://apixies.io/api/v1/format-phone" \
    -H "X-API-Key: YOUR_API_KEY"

JavaScript

fetch("https://apixies.io/api/v1/format-phone", {
    method: "GET",
    headers: {
        "Content-Type": "application/json",
        "X-API-Key": "YOUR_API_KEY"
    }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));

PHP

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://apixies.io/api/v1/format-phone");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "X-API-Key: YOUR_API_KEY"
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Try It Yourself

Test this endpoint directly from your browser using our API sandbox. No authentication required for testing.

Try API Endpoint

This is a limited sandbox environment.

For full, unlimited API access, register for a free account during our beta period.

API Endpoint

/

Sandbox API Usage Get full API access

No token information available

Sandbox limit: 1 token per day with 25 requests per token

Your session has expired. A new token will be created automatically.

Your daily Sandbox API quota has been exhausted. Please try again tomorrow.

Need unlimited access? Register for free and get your own API key with higher limits.

Unable to validate your API token.

Response

Send a request to see the response

Common Use Cases

CRM data normalization

Standardize phone numbers from various input formats into E.164 for consistent storage in your CRM or user database.

International calling features

Convert phone numbers between national and international formats for VoIP applications, click-to-call features, or contact directories.

Form validation

Validate phone numbers in real-time as users type. Detect the country and format before submission to reduce errors.

Related API Endpoints

Explore related endpoints that work well with Phone Number Formatter.

GET Email Inspector

Inspect email address details including format validation, MX record checks, and disposable email de...

GET URL Validator

Validate a URL's format, reachability, SSL status, and response details

GET IP Geolocation

Convert IP addresses to location data including country, city, coordinates, timezone, and ISP inform...

Share Your Feedback

Suggest a micro‑API