Vores API er hurtig og nem at integrere — du kan være i gang på under 15 minutter. Derudover får du 50 gratis forespørgsler hver dag til at komme i gang.
Alle API-anmodninger skal sendes med POST-metoden. Basis-endpoint for alle anmodninger er:
https://numvalid.com/api/v1/[api_key]
Erstat [api_key] med din personlige API-nøgle. Alle anmodningsparametre skal sendes i request body som JSON. Du kan få din API-nøgle fra dit dashboard efter registrering.
Metode: test
Denne metode bruges til at teste API-forbindelsen. Den verificerer, at din API-nøgle er gyldig, og at tjenesten er tilgængelig. Hvis alt er korrekt konfigureret, returnerer API’en et succesfuldt svar.
Eksempel på forespørgsel
{
"method": "test"
}Succesfuldt svar
{
"error": 0,
"message": "Yippee-ki-yay"
}
Svarfelter
error — fejlkode (0 betyder, at anmodningen var succesfuld)
message — svarbesked fra API’en
Metode: info
Info-metoden returnerer oplysninger om din konto og det nuværende abonnement, inklusive antallet af brugte API-forespørgsler.
Eksempel på forespørgsel
{
"method": "info"
}Succesfuldt svar
{
"error": 0,
"name": "John",
"surname": "Smith",
"email": "[email protected]",
"subscription": "Growth",
"count_request": 2349
}
Svarfelter
error — fejlkode (0 betyder, at anmodningen var succesfuld)
name — kontoindehaverens fornavn
surname — kontoindehaverens efternavn
email — kontoens e-mailadresse
subscription — nuværende abonnementsplan
count_request — antal API-forespørgsler brugt i den nuværende abonnementsperiode
Metode: verify
Verify-metoden kontrollerer et telefonnummer og returnerer detaljeret valideringsinformation.
Telefonnumre kan angives i alle formater. API’en håndterer automatisk tegn som (, ), -, + og mellemrum.
Eksempel på forespørgsel
{
"phone": "491609502065",
"method": "verify"
}Succesfuldt svar
{
"error": 0,
"request_phone": "491609502065",
"valid_phone": true,
"type": "mobile",
"format": {
"local": "01609502065",
"international": "+491609502065"
},
"country": {
"code": "DE",
"name": "Germany (Federal Republic of)",
"prefix": "+49"
},
"requests": {
"subscription": "Growth",
"count": 2,
"start": "2026-04-06 10:29:40",
"finish": "2026-10-06 10:29:40",
"limit": 9000
}
}
Svarfelter
error — fejlkode (0 betyder, at anmodningen var succesfuld)
request_phone — telefonnummer sendt i anmodningen
valid_phone — valideringsresultat (true hvis nummeret er gyldigt)
type — telefonnummer type (f.eks. mobil, fastnet osv.)
Format-objekt
local — telefonnummer i lokalt format
international — telefonnummer i internationalt format
Land-objekt
code — ISO landekode
name — landets navn
prefix — internationalt opkaldspræfiks
Requests-objekt
Information om dit nuværende abonnementsforbrug.
subscription — aktiv abonnementsplan
count — antal allerede brugte forespørgsler
start — startdato for abonnementsperioden
finish — slutdato for abonnementsperioden
limit — maksimalt antal tilladte forespørgsler i abonnementsperioden
Har du spørgsmål til vores API-dokumentation? Kontakt os: