Providers

Single provider lookup by NPI

get/api/v1/providers/{npi}

Request

  • Base URL: https://fonteum.com
  • URL: https://fonteum.com/api/v1/providers/{npi}
  • Auth: HTTP bearer

Path parameters

npistring required

Query parameters

max_stalenessstring
Example:48h

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.

max_staleness_mode'flag' | 'reject'

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

Provider record with the per-field provenance available to the response.

Example response

{
  "data": {
    "npi": {
      "source": "CMS NPPES NPI Registry",
      "source_url": "https://npiregistry.cms.hhs.gov/api/"
    },
    "specialty": {
      "source": "CMS NPPES NPI Registry",
      "source_url": "https://npiregistry.cms.hhs.gov/api/"
    },
    "taxonomy_codes": {
      "source": "CMS NPPES NPI Registry",
      "source_url": "https://npiregistry.cms.hhs.gov/api/"
    },
    "taxonomy_primary": {
      "source": "CMS NPPES NPI Registry",
      "source_url": "https://npiregistry.cms.hhs.gov/api/"
    },
    "state": {
      "source": "CMS NPPES NPI Registry",
      "source_url": "https://npiregistry.cms.hhs.gov/api/"
    },
    "city": {
      "source": "CMS NPPES NPI Registry",
      "source_url": "https://npiregistry.cms.hhs.gov/api/"
    },
    "last_updated_in_source": {
      "source": "CMS NPPES NPI Registry",
      "source_url": "https://npiregistry.cms.hhs.gov/api/"
    }
  },
  "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.