Skip to content
GET /api/v1/format-phone

Phone Number Formatter

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

Parameters

name in type required description
phone query string required Phone Number
country_code query string optional ISO 3166-1 alpha-2 (e.g. US, GB, DE) default US

Request

Send your key in the X-API-Key header. More languages and patterns live on the code examples page.

curl -s "https://apixies.io/api/v1/format-phone?phone=%2B1%20%28212%29%20555-1234" \
  -H "X-API-Key: YOUR_API_KEY"

Response

The result sits under data in the standard envelope. See the response format guide for errors and status codes.

returns

data.e164
The number in E.164 form, like +12125551234.
data.is_valid
True when the digit count fits the country's numbering.
data.national
Local dialing format for the country.
data.international
International format with the country prefix.
data.country_code
ISO country code, with the full name in country_name.
example response 200
{
    "status": "success",
    "http_code": 200,
    "code": "SUCCESS",
    "message": "Phone number formatted",
    "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": "2026-09-18T12:00:00+00:00"
    }
}

Authentication and limits

This endpoint needs an API key. Use the sandbox ("try it" above) to test it without registering. See the authentication guide for details.

Standard rate limits apply to this endpoint.

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.

More documentation

Get a free API key

A temporary key takes one click and no signup. Register and you get 75 requests/day. Free tier is for development & small projects.

cookies

We use analytics cookies to see how the site gets used. Nothing loads until you accept. Privacy policy