healthcare

Look up an NPI in the live NPPES registry

Validates an NPI via Luhn checksum, then queries the live CMS NPPES API (https://npiregistry.cms.hhs.gov/api/) for provider details including status (Active/Deactivated), name, credentials, taxonomies, and addresses. If the Luhn check fails, the NPPES call is skipped and the call bills 1 unit instead of 2. If NPPES rejects the query (a non-transient 4xx), the response includes the validation result with an nppes_error code; if NPPES is unreachable, the call fails with a retryable 503 at cost 0. This is a live external call — expect 100-500ms latency.

post/v1/healthcare/npi/lookup

Request

  • Base URL: https://api.snipget.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.snipget.ai/v1/healthcare/npi/lookup
  • Auth: none declared

Query parameters

include_receiptboolean

Set true to attach an execution receipt at meta.receipt — caller-verifiable sha256 hashes over the RFC 8785 (JCS) canonicalization of this call's as-received JSON body and its result (free, like include_trace). Reproduce with any JCS library: input_hash = sha256(jcs({"tool": <request path>, "args": <your body minus include_trace/include_receipt>})); result_hash = sha256(jcs(result)). For deterministic tools, same input on the same build reproduces result_hash.

Headers

authorizationstring nullable
X-API-Keystring nullable

Request body

include_traceboolean

Response

Successful Response

statusstring
confidencenumber required

Changes

No recorded changes to this operation across all 1 revision of this API.