API for udviklere
Slå danske telefonnumre op direkte fra dine egne systemer — firmaoplysninger fra CVR, operatør og en spam-vurdering. Svar i JSON, <1 sekund.
Bygger du en AI-agent? Vi har også en MCP-server (Claude/ChatGPT) oven på samme data.
Godkendelse
Alle kald kræver en API-nøgle i headeren X-API-Key.
Opret konto & køb Pro → for at få en nøgle (eller skriv til
).
X-API-Key: npk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Endpoints
/api/v1/partner/lookup/{nummer}
Opslag af et 8-cifret dansk nummer (eller E.164, fx +4570101000).
curl -H "X-API-Key: $NPK" \ https://nummeropslag.dk/api/v1/partner/lookup/70101000
{
"e164": "+4570101000", "national": "70101000", "type": "service",
"operator": { "name": "TDC", "cvr": "40075291", "country": "DK", "series": "70 10 xx xx" },
"companies": [ { "cvr": "12345678", "name": "Eksempel A/S", "city": "København",
"industry": "Rådgivning", "status": "Aktiv", "kind": "company" } ],
"companies_total": 1,
"firms": [ { "cvr": "12345678", "name": "Eksempel A/S", "city": "København",
"closed": false, "units": [] } ],
"firms_total": 1,
"spam": { "level": "safe", "score": 8, "reports": 2, "contributors": 4,
"positive": 3, "negative": 0, "categories": {}, "verdict": "Erhverv" },
"trust": 78, "trust_zone": "ok", "trust_label": "Troværdig",
"verdict": "Erhverv", "verdict_key": "business", "verdict_cat": null,
"labels": [ { "text": "Erhverv", "tone": "biz", "key": "biz" } ],
"is_private": false, "saved_by": 0, "claimed": null,
"google": { "name": "Eksempel A/S", "rating": 4.6, "reviews": 210, "count": 1,
"maps_uri": "https://maps.google.com/…", "places": [] },
"comments": [],
"assessment": null,
"web_enrich": null
}
/api/v1/partner/me
Status: plan, scopes og månedens forbrug (API + separat MCP).
curl -H "X-API-Key: $NPK" https://nummeropslag.dk/api/v1/partner/me
{ "name": "Din integration", "plan": "pro",
"api": { "quota_monthly": 6000, "rate_per_min": 120, "used_month": 42 },
"mcp": { "quota_monthly": 1000, "rate_per_min": 30, "used_month": 7 } }
/api/v1/partner/spam/{nummer}
Kompakt spam-/trust-vurdering — ideel til caller-ID og opkaldsblokering. Returnerer
level, score, trust/trust_zone/trust_label,
verdict (+ verdict_key), reports, is_private,
official (bekræftet virksomhed) og — hvis markeret — en spam-risk i procent.
/api/v1/partner/operator/{nummer}
Kun operatør og nummertype (mobil/fastnet/service).
/api/v1/partner/search?q=navn
Søg virksomheder på navn (CVR). Kræver search-scope.
Det fulde lookup-svar rummer alle felter fra sitet: firmaer (CVR),
operatør, spam/trust, verdict, labels, is_private,
google, saved_by, comments, samt assessment
(vores spam-analyse) og web_enrich — de to sidste udfyldes asynkront og kan være
null ved første opslag; de fyldes ud ved efterfølgende kald. Den autoritative
feltliste er altid OpenAPI-specen.
Kvoter & fejl
200 | OK — JSON-svar |
401 | Ugyldig eller manglende X-API-Key |
429 | Rate eller månedlig kvote brugt op (API el. MCP) |
Pro (179 kr./md, faktureret årligt): 6,000 API-opslag/md + 1,000 MCP-kald/md, 120/min. MCP-kald (header X-Client: mcp) tæller mod en separat, lavere kvote. Se pris →
Vilkår
Data stammer fra offentlige kilder (CVR, Nummerregistret/SDFI) samt anonyme brugerrapporter. Spam-vurderinger er vejledende. Gem ikke personoplysninger om private. Se privatlivspolitik.
Få en API-nøgle
Skriv til os, så vender vi tilbage med en nøgle. Linket åbner din e-mail med emne og en kort skabelon klar.