Vorwahl-Daten per JSON

Telefonnummern, Vorwahlen und Länder zuverlässig erkennen.

Die vorwahl.app API liefert strukturierte Daten für Ortsvorwahlen, internationale Landesvorwahlen, Servicenummern, Notrufnummern und die Umwandlung lokaler Telefonnummern ins internationale Format. Entwickelt für Shops, CRM-Systeme, Support-Tools, Lead-Formulare und interne Datenqualität.

Schlüssel erstellen Quickstart

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 Datensätze

5.200 deutsche Ortsnetze

206 Länder und Gebiete

76 Service- und Notrufbereiche

382 Mobilfunkbereiche

Quickstart

In wenigen Minuten zur ersten Abfrage.

Konto bestätigen

Registriere dich im Kundenkonto und bestätige deine E-Mail-Adresse.

Schlüssel erstellen

Lege einen API-Schlüssel an. Er wird nur einmal im Klartext angezeigt.

JSON abrufen

Sende den Schlüssel ausschließlich als Bearer Token im Authorization-Header.

Bearer Token

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

Schlüssel sicher übertragen

API-Schlüssel gehören nie in URLs, Browserhistorien, Proxy-Logs oder Referrer. Query-Parameter werden deshalb nicht akzeptiert.

Endpunkte

Klare JSON-Endpunkte für Suche, Konto und Billing.

GET

/api/search.php

Sucht nach Vorwahl, Telefonnummer, Ort, Land, Service- oder Notrufnummer.

Parameter	Beschreibung
q	Suchbegriff, z. B. `030`, `Berlin`, `+44`, `0800`.
limit	Optional, 1 bis 50 Ergebnisse. Standard: 12.

GET

/api/internationalize.php

Wandelt eine lokale Telefonnummer eines Landes in ein internationales, kopierbares Format um.

Parameter	Beschreibung
number	Lokale Nummer, z. B. `0343 222 1234`.
country	ISO-Ländercode der Nummer, z. B. `GB`, `DE`, `AT`. Standard: `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

Liefert Status und aktuelle Zähler der Datenbasis.

GET

/api/billing/plans.php

Liefert verfügbare API-Pakete, Limits und PayPal-Status.

POST

/api/account/api-keys.php

Erstellt einen API-Schlüssel für angemeldete und bestätigte Nutzer.

Antwortformat

Ein Treffer enthält alles für Anzeige, Prüfung und Formatierung.

codeVorwahl oder Rufnummerngasse, z. B. 030 oder +49.

nameOrt, Land, Dienst oder Notrufbezeichnung.

kindOrt, Land, Region, Dienst, Notruf.

local_formatEmpfohlenes nationales Anzeigeformat.

international_formatEmpfohlenes internationales Anzeigeformat.

adviceNutzerfreundlicher Hinweis zu Kosten, Nutzung oder Wahlweise.

API-Pakete

Planbare Monatskontingente mit fairer kostenloser Nutzung.

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