Identità e verifica

API di ricerca NPI e verifica degli operatori sanitari

Verifica medici, cliniche e altri operatori sanitari durante accreditamento, richieste di rimborso e onboarding. Cerca un NPI nel registro ufficiale, confronta nome, stato e specialità con la scheda oppure cerca gli operatori per nome e località.

Categoria Identità e verifica
Endpoint 1
Caratteristiche Principali 4
Domande frequenti 4

Usato da persone di queste aziende

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse

Segnali di fiducia prima dell’integrazione

Documentazione trasparente, richieste autenticate e dettagli di affidabilità visibili rendono più semplice valutare DomScan prima del rilascio.

In tempo reale Stato del servizio

Controlla lo stato del servizio in tempo reale e le risposte di errore documentate prima dell’integrazione.

OpenAPI Artefatti API

OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.

Chiavi API Accesso protetto

Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.

10,000 Quota gratuita

Inizia con 10.000 crediti mensili e fai upgrade solo quando l’uso cresce.

Cosa ti aiuta a costruire questa API

Usa questa pagina come brief di produzione: endpoint, esempi, forma della risposta e parti del workflow per integrare DomScan nel tuo prodotto.

Workflow di prodotto

Integra controlli dominio, intelligence DNS, segnali di rischio o arricchimento in onboarding, ricerca e strumenti interni.

Automazione per analisti

Sostituisci lookup manuali ripetuti con job pianificati, alert e passaggi di indagine riproducibili.

Dati JSON puliti

Usa campi prevedibili, codici di stato documentati e costi in crediti invece di fare scraping di pagine provider.

AI e strumenti ops

Alimenta agenti, dashboard, playbook SOAR e CRM tramite OpenAPI, SDK, Postman o MCP.

Workflow di integrazione

Un percorso semplice dalla prima richiesta all’uso ripetibile in produzione.

1
Autentica una volta

Invia la tua chiave API con l’header documentato e mantieni richieste coerenti tra servizi.

2
Interroga con esempi

Parti dagli esempi curl e HTTP, poi mappa i parametri nel codice della tua applicazione.

3
Opera e monitora

Usa codici di stato, costi in crediti e campi di risposta per costruire retry, log e alert.

Kit sviluppatori

Passa da questa pagina a docs leggibili da macchina, raccolte di richieste, SDK o strumenti per agenti.

Mappa di parametri e risposta

Controlla input, campi di output e codici di stato prima di collegare l’endpoint al tuo client.

Parametri richiesta

Parametro

numbernamestatetaxonomy
Campi risposta

Risposta di esempio

npistatuschecksum_validproviderprovider.typeprovider.nameprovider.activeprovider.primary_taxonomyprovider.primary_taxonomy.codeprovider.primary_taxonomy.descriptionprovider.primary_taxonomy.stateprovider.primary_taxonomy.license
Copertura stati

Codici di stato HTTP

200400401402429

Endpoint

GET /v1/npi
Crediti: 1Autenticazione: Autenticazione richiesta

Segnali di fiducia prima dell’integrazione

Documentazione trasparente, richieste autenticate e dettagli di affidabilità visibili rendono più semplice valutare DomScan prima del rilascio.

In tempo reale Stato del servizio

Controlla lo stato del servizio in tempo reale e le risposte di errore documentate prima dell’integrazione.

OpenAPI Artefatti API

OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.

Chiavi API Accesso protetto

Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.

10,000 Quota gratuita

Inizia con 10.000 crediti mensili e fai upgrade solo quando l’uso cresce.

Caratteristiche Principali

Scheda del registro ufficiale

La scheda aggiornata dal registro NPI ufficiale USA: individuale o organizzazione, titoli professionali, date di assegnazione e di aggiornamento, e stato.

Specialità e licenze

Ogni classificazione con il numero di licenza e lo stato, sedi di attività, indirizzo postale, altri identificativi e nomi precedenti.

Un’unica risposta di verifica

Invia nome, stato e specialità da confrontare. Verified è true solo quando l’operatore è attivo e ogni dato inviato corrisponde.

Ricerca per nome

Trova gli operatori per nome individuale o dell’organizzazione con filtri per città, stato, CAP e specialità, fino a 50 per pagina.

Richiesta di esempio

GET /v1/npi?number=1003000126&state=MD bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/npi?number=1003000126&state=MD"

Risposta di esempio

200 OK json
{
  "npi": "1003000126",
  "status": "found",
  "checksum_valid": true,
  "provider": {
    "type": "individual",
    "name": "ARDALAN ENKESHAFI",
    "active": true,
    "primary_taxonomy": { "code": "208M00000X", "description": "Hospitalist", "state": "DC", "license": "MD600003480" },
    "addresses": { "location": { "city": "BETHESDA", "state": "MD" } }
  },
  "verification": {
    "state": { "status": "match", "matched_on": "location" },
    "verified": true
  }
}

Domande frequenti

Cosa succede con un NPI digitato male?

Ogni NPI ha una cifra di controllo. Un numero che non la supera viene segnalato subito come non valido, senza cercare nel registro.

Cosa significa not_found?

Il numero è formato correttamente ma il registro non ha alcuna scheda attiva per esso. I numeri disattivati non sono elencati dal registro.

E se il registro non è disponibile?

Il risultato è sconosciuto con il motivo, mai non trovato, e la richiesta viene rimborsata.

Quanti crediti costa?

Un credito per ricerca o per pagina di ricerca. I risultati sconosciuti vengono rimborsati.

Strumenti e risorse correlati

Codici di stato HTTP

Questi sono i codici di stato HTTP da gestire, per distinguere risposte riuscite, problemi di autenticazione, crediti, limiti di frequenza, dati mancanti ed errori a monte.

OK 200

Richiesta riuscita

Richiesta non valida 400

Parametri non validi

Non autorizzato 401

Chiave API o sessione mancante o non valida.

Pagamento richiesto 402

Crediti insufficienti per eseguire questa richiesta.

Troppe richieste 429

Limite di richieste superato