Calling code data as JSON

Reliably identify phone numbers, calling codes and countries.

The phonecode.app API provides structured data for local area codes, international country calling codes, service and emergency numbers, and converting local phone numbers to international format. Built for shops, CRM systems, support tools, lead forms and internal data quality.

Create key Quick start

GET /api/search.php?q=030 JSON

{
  "ok": true,
  "query": "030",
  "results": [
    {
      "code": "030",
      "name": "Berlin",
      "region": "Deutschland",
      "kind": "Ort",
      "format": "+49 30"
    }
  ]
}

28,608 Records

5,200 German local networks

206 countries and territories

76 Service and emergency ranges

382 Mobile ranges

Quick start

Your first request in minutes.

Verify account

Create key

Create an API key. Its plaintext value is shown only once.

Retrieve JSON

Send the key only as a Bearer Token in the Authorization header.

Bearer Token

curl "https://vorwahl.app/api/search.php?q=040" \
  -H "Authorization: Bearer vwl_DEIN_API_SCHLUESSEL"

Transmit keys securely

API keys must never appear in URLs, browser history, proxy logs or referrers. Query parameters are therefore not accepted.

Endpoints

Clear JSON endpoints for search, accounts and billing.

GET

/api/search.php

Searches calling codes, phone numbers, places, countries, service or emergency numbers.

Parameter	Description
q	Search term, for example `030`, `Berlin`, `+44`, `0800`.
limit	Optional, 1 to 50 results. Default: 12.

GET

/api/internationalize.php

Converts a country's local phone number into a copyable international format.

Parameter	Description
number	Local number, for example `0343 222 1234`.
country	ISO country code of the number, for example `GB`, `DE`, `AT`. Default: `DE`.

curl "https://vorwahl.app/api/internationalize.php?number=0343%20222%201234&country=GB" \
  -H "Authorization: Bearer vwl_DEIN_API_SCHLUESSEL"

{
  "ok": true,
  "input": "0343 222 1234",
  "country": "GB",
  "international": "+44 343 222 1234"
}

GET

/api/health.php

Returns status and current dataset counts.

GET

/api/billing/plans.php

Returns available API plans, limits and PayPal status.

POST

/api/account/api-keys.php

Creates an API key for signed-in, verified users.

Response format

Each result contains the data needed for display, validation and formatting.

codeCalling code or number range, for example 030 or +49.

namePlace, country, service or emergency designation.

kindOrt, Land, Region, Dienst, Notruf.

local_formatRecommended national display format.

international_formatRecommended international display format.

adviceUser-friendly advice on costs, usage or dialling method.

API plans

Predictable monthly quotas with fair free usage.

Free

€0.00

searches/day: 5
Searches/month: 150
Internationalizer: 2 per day
API keys: 1

Available online

Pro

€9.90 / month

searches/day: 1,000
Searches/month: 10,000
Internationalizer: 100 per day
API keys: 5

Available online

Business

€49.00 / month

searches/day: 10,000
Searches/month: 250,000
Internationalizer: 1,000 per day
API keys: 50

Available online

Business Pro

€99.00 / month

searches/day: 1,000,000
Searches/month: 10,000,000
Internationalizer: Unlimited
API keys: 100

On request

Counts load live from /api/health.php and /api/billing/plans.php. When a limit is exceeded, the API returns HTTP 429 with a reference to the customer account.

Error codes

Predictable responses for robust integrations.

401Invalid API key or user not signed in.

403Email address not yet verified.

422Required field missing or invalid input.

429Daily or monthly limit reached.

503Database or payment provider temporarily unavailable.

Support

Questions about integration?

Write to us with your use case, expected load and required data scope.

app_support@cesinger.de