---
title: "Exact OIG exclusion signals for one NPI"
method: GET
path: "/api/v1/npi/{npi}/risk"
tags: ["NpiEntityResolution"]
---

# Exact OIG exclusion signals for one NPI

`GET /api/v1/npi/{npi}/risk`

## Request

- Base URL: `https://fonteum.com`
- URL: `https://fonteum.com/api/v1/npi/{npi}/risk`
- Auth: HTTP bearer

API-key-only exact NPI matching against OIG LEIE serving rows. This endpoint returns public-record exclusion signals and the provenance fields available to the match; it does not compute a risk score or certification. A zero-signal result is returned only when the endpoint's coverage guard reports `current` after reconciling the serving table to its comparable internal artifact; that status does not assert same-day upstream freshness. When coverage trails or cannot reconcile, HTTP 503 returns `determination: indeterminate`, coverage evidence, and `Cache-Control: private, no-store`; that response is not a clearance. Positive signals remain HTTP 200 and disclose the coverage status.

## Path parameters

- `npi` string, required

## Response `200`

One or more exact exclusion signals, or a zero-signal result when the endpoint's internal coverage guard reports reconciled current coverage.

- object
  - `npi` string, required
  - `signals` object[], required
    - `npi` string
    - `signal_type` 'exclusion'
    - `evidence` object
    - `detected_at` string, date-time
  - `checked_at` string, date-time, required
  - `from_cache` boolean, required
  - `determination` 'match' | 'no_match' | 'indeterminate', required
  - `coverage_status` 'current' | 'coverage_stale' | 'indeterminate', required
  - `coverage` ExclusionCoverage, required
    - `status` 'current' | 'coverage_stale' | 'indeterminate', required
    - `sources` object, required
    - `message` string, required
  - `warning` string
  - `_provenance` object, required
  - `meta` object, required

## Other responses

- `400`: NPI is not exactly 10 digits.
- `401`: Missing or invalid API key.
- `429`: Rate limit exceeded.
- `502`: Serving-table retrieval failed.
- `503`: Zero-signal result with stale or unreconciled OIG coverage. The response uses the same body schema as 200, with `determination: indeterminate`; no negative determination was made.

---

[API](https://skmtc.dev/fonteum/apis/fonteum-api.md) · [All operations](https://skmtc.dev/fonteum/apis/fonteum-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fonteum/apis/fonteum-api/revisions/334e6e179d0d?raw)
