Controleer vóór de integratie de live servicestatus en de gedocumenteerde foutreacties.
Vertrouwenssignalen voordat je integreert
Transparante documentatie, geauthenticeerde requests en zichtbare betrouwbaarheidsdetails maken DomScan makkelijker te beoordelen voor livegang.
OpenAPI, Swagger, Postman, CLI, SDK en MCP-links zijn één klik verwijderd.
Geauthenticeerde endpoints gebruiken API-sleutels met duidelijke creditkosten voordat je ze aanroept.
Begin met 10.000 maandelijkse credits en upgrade pas wanneer het gebruik groeit.
Wat deze API je helpt bouwen
Gebruik deze pagina als productiebriefing: endpoints, voorbeelden, responsstructuur en workflow-onderdelen om DomScan in je product te koppelen.
Integreer domeinchecks, DNS-intelligence, risicosignalen of verrijking in onboarding, zoeken en interne tools.
Vervang herhaalde handmatige lookups door geplande taken, alerts en reproduceerbare onderzoeksstappen.
Gebruik voorspelbare velden, gedocumenteerde statuscodes en kredietkosten in plaats van providerpagina’s te scrapen.
Voed agents, dashboards, SOAR-playbooks en CRMs via OpenAPI, SDK, Postman of MCP.
Integratieworkflow
Een eenvoudig pad van de eerste request naar herhaalbaar productiegebruik.
Stuur je API-sleutel met de gedocumenteerde header en houd requests consistent tussen services.
Start met de curl- en HTTP-voorbeelden en map daarna de parameters naar je applicatiecode.
Gebruik statuscodes, kredietkosten en responsvelden om retries, logs en alerts te bouwen.
Developerkit
Ga vanaf deze pagina naar machineleesbare docs, requestcollecties, SDKs of agenttools.
Genereer clients of inspecteer elke request- en responsvorm.
Postman-collectieImporteer kant-en-klare requests voor handmatig testen en overdracht aan het team.
SDKs en CLIGebruik onderhouden pakketten en commandline-workflows in plaats van boilerplate te schrijven.
MCP-integratieStel domeinintelligence beschikbaar aan AI-agents en interne assistentworkflows.
Parameter- en responskaart
Bekijk inputs, outputvelden en statuscodes voordat je het endpoint in je client aansluit.
Parameter
Voorbeeldantwoord
HTTP-statuscodes
Endpoints
/v1/phone/validate
/v1/phone/validate/bulk
Vertrouwenssignalen voordat je integreert
Transparante documentatie, geauthenticeerde requests en zichtbare betrouwbaarheidsdetails maken DomScan makkelijker te beoordelen voor livegang.
OpenAPI, Swagger, Postman, CLI, SDK en MCP-links zijn één klik verwijderd.
Geauthenticeerde endpoints gebruiken API-sleutels met duidelijke creditkosten voordat je ze aanroept.
Begin met 10.000 maandelijkse credits en upgrade pas wanneer het gebruik groeit.
Start met de curl- en HTTP-voorbeelden en map daarna de parameters naar je applicatiecode.
Belangrijkste functies
Controleer de lengte en cijferpatronen met volledige nummerplanmetadata, niet alleen op basis van de lengte.
Ontvang de formaten E.164, internationaal, nationaal en RFC 3966, inclusief herkende extensies.
Onderscheid nummers met een aannemelijke lengte van nummerbereiken die door het nummerplan worden herkend.
Bepaal het nummertype, de nummerplanlocatie, mogelijke tijdzones, de oorspronkelijke provider en ondersteuning voor nummerportabiliteit wanneer de metadata dit bevat.
Analyseer nationale nummers met een land, genereer een belnotatie voor het land van herkomst en herken regionale verkorte nummers en alarmnummers.
Valideer maximaal 100 nummers per aanvraag, met een afzonderlijk resultaat voor elke invoer.
Gebruik offline metadata en openbare momentopnamen van toezichthouders op de infrastructuur van DomScan. Overeenkomende resultaten bevatten de bron, licentie, bijwerkdatum en context van de oorspronkelijke toewijzing.
Voorbeeldverzoek
curl -X POST https://domscan.net/v1/phone/validate \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"phone":"+34 612 345 678","expected_country":"ES","dialing_from_country":"US","language":"en"}'
Voorbeeldantwoord
{
"input": "+34 612 345 678",
"normalized_input": "+34 612 345 678",
"kind": "phone_number",
"valid": true,
"possible": true,
"status": "valid",
"recommendation": "accept",
"validation_level": "numbering_plan",
"reason": null,
"warnings": [],
"number": {
"e164": "+34612345678",
"international": "+34 612 34 56 78",
"national": "612 34 56 78",
"rfc3966": "tel:+34612345678",
"national_number": "612345678",
"extension": null,
"country": "ES",
"country_name": "Spain",
"country_calling_code": "34",
"possible_countries": ["ES"],
"country_match": true,
"type": "mobile",
"non_geographic": false
},
"intelligence": {
"status": "available",
"kind": "phone_number",
"coverage": {
"country": "ES",
"level": "official_allocation_match",
"global_numbering_metadata": true,
"official_snapshot_available": true,
"official_allocation_match": true,
"official_source_ids": ["cnmc"],
"matching_source_ids": ["cnmc"],
"current_carrier_lookup": false
},
"location": {
"country_name": "Spain",
"country": "ES",
"granularity": "country",
"current_physical_location": false
},
"possible_time_zones": {
"values": ["Europe/Madrid"],
"current_location": false,
"inference": "number_prefix"
},
"original_prefix_carrier": {
"name": "FOOTBALLERISTA MOBILE SPAIN, S.A. UNIPERSONAL",
"source_id": "cnmc",
"evidence": "official_allocation_record",
"current_carrier": false,
"portability_may_change_carrier": true
},
"portability": {
"region_supported": true,
"current_port_checked": false
},
"dialing": {
"from_country": "US",
"international": "011 34 612 34 56 78",
"internationally_diallable": true
},
"regulator_allocations": [{
"authority": "CNMC",
"category": "mobile",
"status": "assigned",
"original_assignee": "FOOTBALLERISTA MOBILE SPAIN, S.A. UNIPERSONAL",
"assigned_on": "2023-11-03",
"current_operator": false,
"individual_number_assignment_checked": false
}],
"sources": [{
"id": "google_libphonenumber",
"name": "Google libphonenumber metadata",
"license": "Apache-2.0"
}, {
"id": "cnmc",
"name": "Comisión Nacional de los Mercados y la Competencia (CNMC)",
"type": "official_regulator_snapshot"
}]
},
"live_checks": {
"assignment": "not_checked",
"reachability": "not_checked",
"current_carrier": "not_checked",
"subscriber_identity": "not_checked",
"porting": "not_checked"
},
"privacy": {
"upstream_requests": 0,
"telecom_provider_queried": false,
"persisted": false,
"domscan_edge_relay_used": true,
"third_party_requests": 0
},
"limitations": [
"NUMBERING_PLAN_ONLY",
"DOES_NOT_PROVE_ASSIGNMENT",
"NO_LIVE_TELECOM_CHECKS"
],
"credits_used": 1
}
Veelgestelde vragen
Geldig betekent dat het nummer overeenkomt met de vastgelegde lengte en cijferpatronen van een herkend nummerplanbereik. Het betekent niet dat het nummer aan een abonnee is toegewezen.
Nee. Nummerplanvalidatie kan niet bevestigen dat een nummer is toegewezen, actief of bereikbaar is, of oproepen of sms-berichten kan ontvangen.
De API kan de oorspronkelijke provider van een nummerblok of de houder van een toewijzing door de toezichthouder retourneren. Geen van beide velden vermeldt de huidige provider na nummerportering en geen van beide identificeert de abonnee of eigenaar van het telefoonnummer.
Ja. Geef een standaardland of -regio op als het nummer niet met een internationaal landnummer begint. Er is ook een land nodig om regionale verkorte nummers en alarmnummers te interpreteren.
Wereldwijde metadata komt van Google libphonenumber. Officieel bewijs voor nummerblokken en voorvoegsels kan ook afkomstig zijn uit openbare momentopnamen van CNMC, ARCEP, Bundesnetzagentur, MIC Japan, RTR Oostenrijk, Nkom, UKE Polen, MODA Taiwan, NANPA voor de Verenigde Staten en CNA/CNAC voor Canada. Amerikaanse en Canadese gegevens beschrijven de status van NPA-NXX-centralecodes en de oorspronkelijke houders van de codes, niet de huidige provider van een geporteerd nummer. Elk resultaat vermeldt de bronnen, momentopnamedatums en het dekkingsniveau. Locatie en tijdzones beschrijven het nummerplanblok, niet de huidige locatie van de telefoon.
Ja. Het bulkendpoint accepteert maximaal 100 nummers en retourneert de resultaten in de volgorde van de invoer. Als offline verrijking niet beschikbaar is, wordt de lokale validatie toch voltooid en vermeldt intelligence.status de terugvalstatus.
Gerelateerde hulpprogramma's en bronnen
HTTP-statuscodes
We documenteren de HTTP-statuscodes die je client moet afhandelen, zodat je succesvolle responses, authenticatieproblemen, credits, ratelimieten, ontbrekende gegevens en upstreamfouten kunt onderscheiden.
Aanvraag geslaagd
Ongeldige parameters
API-sleutel of sessie ontbreekt of is ongeldig.
Niet genoeg credits om deze aanvraag uit te voeren.
Snelheidslimiet overschreden
Interne fout
Upstream RDAP-fout
De upstreamservice is niet beschikbaar of beperkt tijdelijk aanvragen.
De upstream-aanvraag heeft de tijdslimiet overschreden.
Probeer telefoonnummerinformatie gratis