Providers

Read CMS QPP MIPS scores for one NPI

Returns the CMS-published MIPS final score, four category scores, and participation type for each loaded performance year, newest first. The production table has no populated payment-adjustment percentage field, so this contract does not advertise or emit one. found=false means no row is present in the data Fonteum currently holds; it does not establish that the clinician did not participate. Re-confirm consequential use at qpp.cms.gov.

get/api/v1/qpp-mips/{npi}

Request

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

Path parameters

npistring required

Exact 10-digit National Provider Identifier.

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

Loaded QPP MIPS history for the NPI, or found=false when no row is present.

provenanceobject required

CMS QPP source, source URL, performance-year snapshot, methodology, license, coverage period, and serve-time fields available from the shared provenance builder.

disclaimerstring required

Example response

{
  "meta": {
    "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.