phonecode.app API · Documentatie

Netnummergegevens als JSON

Herken telefoonnummers, netnummers en landen betrouwbaar.

De phonecode.app API levert gestructureerde gegevens voor lokale en internationale netnummers, service- en alarmnummers en het omzetten van lokale telefoonnummers naar internationaal formaat. Ontwikkeld voor winkels, CRM-systemen, supporttools, leadformulieren en interne datakwaliteit.

28.608 Records
5.200 Duitse lokale netwerken
206 landen en gebieden
76 Service- en alarmnummerreeksen
382 Mobiele nummerreeksen

Snel starten

Je eerste aanvraag binnen enkele minuten.

1

Account bevestigen

Registreer een klantaccount en bevestig je e-mailadres.

2

Sleutel maken

Maak een API-sleutel aan. Deze wordt maar één keer leesbaar getoond.

3

JSON ophalen

Stuur de sleutel uitsluitend als Bearer Token in de Authorization-header.

Bearer Token

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

Sleutels veilig versturen

API-sleutels horen nooit in URL’s, browsergeschiedenis, proxylogs of verwijzende adressen. Queryparameters worden daarom niet geaccepteerd.

Eindpunten

Duidelijke JSON-eindpunten voor zoeken, accounts en facturering.

GET

/api/search.php

Zoekt netnummers, telefoonnummers, plaatsen, landen en service- of alarmnummers.

ParameterBeschrijving
qZoekterm, bijvoorbeeld 030, Berlin, +44, 0800.
limitOptioneel, 1 tot 50 resultaten. Standaard: 12.
GET

/api/internationalize.php

Zet een lokaal telefoonnummer uit een land om naar kopieerbaar internationaal formaat.

ParameterBeschrijving
numberLokaal nummer, bijvoorbeeld 0343 222 1234.
countryISO-landcode van het nummer, bijvoorbeeld GB, DE, AT. Standaard: 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

Geeft de status en actuele aantallen van de gegevens terug.

GET

/api/billing/plans.php

Geeft beschikbare API-pakketten, limieten en PayPal-status terug.

POST

/api/account/api-keys.php

Maakt een API-sleutel voor aangemelde en bevestigde gebruikers.

Antwoordformaat

Elk resultaat bevat gegevens voor weergave, controle en opmaak.

codeNetnummer of nummerreeks, bijvoorbeeld 030 of +49.
namePlaats, land, dienst of aanduiding van een alarmnummer.
kindOrt, Land, Region, Dienst, Notruf.
local_formatAanbevolen nationaal weergaveformaat.
international_formatAanbevolen internationaal weergaveformaat.
adviceBegrijpelijke uitleg over kosten, gebruik of kieswijze.

API-plannen

Voorspelbare maandquota met eerlijk gratis gebruik.

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