Vårt API är snabbt och enkelt att integrera — du kan vara igång på under 15 minuter. Dessutom får du 50 gratis förfrågningar varje dag för att komma igång.
Alla API-anrop måste skickas med POST-metoden. Bas-endpoint för alla anrop är:
https://numvalid.com/api/v1/[api_key]
Ersätt [api_key] med din personliga API-nyckel. Alla parametrar måste skickas i request body som JSON. Du kan hämta din API-nyckel från din dashboard efter registrering.
Metod: test
Denna metod används för att testa API-anslutningen. Den verifierar att din API-nyckel är giltig och att tjänsten är tillgänglig. Om allt är korrekt konfigurerat returnerar API:t ett lyckat svar.
Exempel på request
{
"method": "test"
}Lyckat svar
{
"error": 0,
"message": "Yippee-ki-yay"
}
Svarsfält
error — felkod (0 betyder att anropet lyckades)
message — svarsmeddelande från API:t
Metod: info
Info-metoden returnerar information om ditt konto och din aktuella prenumeration, inklusive antal använda API-anrop.
Exempel på request
{
"method": "info"
}Lyckat svar
{
"error": 0,
"name": "John",
"surname": "Smith",
"email": "[email protected]",
"subscription": "Growth",
"count_request": 2349
}
Svarsfält
error — felkod (0 betyder att anropet lyckades)
name — kontots förnamn
surname — kontots efternamn
email — kontots e-postadress
subscription — nuvarande abonnemangsplan
count_request — antal API-anrop som använts under den aktuella abonnemangsperioden
Metod: verify
Verify-metoden kontrollerar ett telefonnummer och returnerar detaljerad valideringsinformation.
Telefonnummer kan anges i vilket format som helst. API:t hanterar automatiskt tecken som (, ), -, + och mellanslag.
Exempel på request
{
"phone": "491609502065",
"method": "verify"
}Lyckat 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
}
}
Svarsfält
error — felkod (0 betyder att anropet lyckades)
request_phone — telefonnummer som skickas i requesten
valid_phone — valideringsresultat (true om numret är giltigt)
type — telefonnummerstyp (t.ex. mobil, fast telefon etc.)
Formatobjekt
local — telefonnummer i lokalt format
international — telefonnummer i internationellt format
Landobjekt
code — ISO-landskod
name — landets namn
prefix — internationell riktnummerprefix
Requests-objekt
Information om din nuvarande abonnemangsanvändning.
subscription — aktivt abonnemang
count — antal redan använda anrop
start — startdatum för abonnemangsperioden
finish — slutdatum för abonnemangsperioden
limit — maximalt antal tillåtna anrop under abonnemangsperioden
Har du frågor om vår API-dokumentation? Kontakta oss: