Utilities · Data API

Country Calling Codes

A complete list of international dialling codes for every country.

Provides a simple, accurate mapping between countries and their international telephone calling codes (e.g., +61 for Australia). This foundational dataset is essential for any application that needs to validate, format, or identify the origin of user-provided phone numbers.

Get API key View docs

Source: DataHub Core (via `datasets/country-codes`) · ODbL · DataHub.io, country-codes

Endpoints

Every request is authenticated with your X-API-Key and counted against your plan.

GET /v1/data/country-calling-codes
GET /v1/data/country-calling-codes/search?q=...
GET /v1/data/country-calling-codes/{key}

Base path /v1/data/country-calling-codes · full reference in the interactive docs. Also exposed as an MCP tool for AI agents.

Fields

Field	Type	Description
country_name	str	The commonly used name of the country.
iso2	str	The 2-letter ISO 3166-1 alpha-2 country code.
iso3	str	The 3-letter ISO 3166-1 alpha-3 country code.
calling_code	str	The international dialling prefix for the country (e.g., '61' for Australia).
continent	str	The two-letter continent code (e.g., OC for Oceania).

What you get

Comprehensive list of all country calling codes.

Includes ISO 3166-1 alpha-2 and alpha-3 codes for easy joins.

Lookup by country name or ISO code.

Lightweight and fast.

Sourced from a well-maintained open dataset.

FAQ

Does this include regions and territories?: Yes, the dataset includes dialling codes for non-sovereign territories where they have their own code, such as Puerto Rico or Guam.
How are multiple codes for one country (e.g., USA) handled?: The dataset provides the primary country code. For countries within the North American Numbering Plan, it returns '1'.

Pricing

Simple, transparent pricing

Start free, upgrade when you need more. All plans include full API access.

Free

$0forever

Get started and explore the API

100 requests/day

100 API requests per day
All endpoints included
Community support

Get Started

Pro

$9/month

For production apps and AI agents

10,000 requests/day

10,000 API requests per day
All endpoints included
Priority support
Usage dashboard

Upgrade to Pro

Enterprise

$49/month

Unlimited access for high-volume use

Unlimited requests

Unlimited API requests
All endpoints included
Priority support
Usage dashboard
Dedicated support channel

Go Enterprise

Getting Started

Start building in minutes

Register

Create an account to get your API key. It's free — no credit card required.

curl -X POST https://api.aristocles.com.au/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "name": "Your Name"}'

Make a request

Use your API key in the X-API-Key header to authenticate requests.

curl https://api.aristocles.com.au/v1/data/asx \
  -H "X-API-Key: your_api_key_here"

Upgrade

Need more requests? Upgrade to Pro or Enterprise — you'll be redirected to Stripe Checkout.

curl -X POST "https://api.aristocles.com.au/v1/billing/checkout?tier=pro" \
  -H "X-API-Key: your_api_key_here"

Check usage

Monitor your daily request count and remaining quota at any time.

curl https://api.aristocles.com.au/v1/usage \
  -H "X-API-Key: your_api_key_here"