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.

Das Lizenzangebot richtet sich ausschließlich an Unternehmen. Aufgrund der Kleinunternehmerregelung gemäß § 19 UStG wird keine Umsatzsteuer berechnet.