Cross-dataset entity resolution by NPI
Returns the source blocks available for an NPI from NPPES, OIG LEIE, PECOS, QPP MIPS, CMS Open Payments, and SAM.gov. A block can be absent, and provenance fields within a block can be null. Exclusion booleans are nullable: a no-match is emitted only when the internal coverage guard reports reconciled current; that state does not assert same-day upstream freshness. Stale or unreconciled coverage returns determination: indeterminate and is not a clearance.
Requires Authorization: Bearer fnt_... and uses the key's configured limits.
Caching: Cache-Control: no-store; a newer comparable exclusion artifact can invalidate a prior negative immediately.
Request
- Base URL: https://fonteum.com
- URL: https://fonteum.com/api/v1/npi/{npi}
- Auth: HTTP bearer
Path parameters
10-digit NPI (National Provider Identifier).
Query parameters
Caller stored-snapshot age bar (moat-defense #125). A positive duration — 48h, 7d, 90m, or a bare number of hours. The maximum age any consulted stored source snapshot may have for this request; it is not an upstream-release freshness guarantee. Response carries meta.freshness_policy; absence of the parameter leaves default behaviour unchanged.
What to do when a source is behind the max_staleness bar: flag (default) returns 200 with a stale flag; reject returns 409. on_stale=reject|409 is accepted as an alias.
Response
Resolved provider record with the available source blocks and nullable per-source provenance fields.
Example response
{
"data": {
"npi": "1174785802"
},
"meta": {
"request_id": "req_abc123def456",
"freshness": [
{
"source_id": "oig-leie"
}
],
"freshness_policy": {
"max_staleness": "48h",
"max_staleness_hours": 48
}
}
}Changes
No recorded changes to this operation across all 1 revision of this API.