---
title: "Three more public records for one NPI of a provider check: its Medicare contractor, its state Medicaid enrollment and the SAM.gov exclusion list."
method: POST
path: "/v1/provider-checks/{id}/extras"
tags: ["Provider checks"]
---

# Three more public records for one NPI of a provider check: its Medicare contractor, its state Medicaid enrollment and the SAM.gov exclusion list.

`POST /v1/provider-checks/{id}/extras`

## Request

- Base URL: `https://www.licium.ai`
- URL: `https://www.licium.ai/v1/provider-checks/{id}/extras`
- Auth: none required

Send the email that sent the list and one NPI of that check, within 24 hours of sending it. Returns one line per record, each with its source link and read time and a state: read (the source answered; a real negative is said in the summary), needs_person (a person must look; reason says why) or not_covered (not read automatically; reason says why). Medicaid has one line per state (the practice state, the states of the provider's licenses, then the mailing state; at most four). A SAM.gov listing by NPI has facts.excluded true; a possible match by name is needs_person. These records are not part of the check's rows or its emailed table. Reading takes up to about 20 seconds. Limits: 30 requests per address per 10 minutes; up to 25 NPIs and 50 requests per check; and an overall limit across callers. Past a limit the answer is 429.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `email` string, email, required: The email that sent the list.
  - `npi` string, required: One NPI of this check.

## Response `200`

The lines for this NPI.

- object
  - `success` unknown
  - `data` object
    - `request_id` string, uuid
    - `npi` string
    - `name` string, nullable: The name in the national registry.
    - `credential` string, nullable
    - `read_at` string, date-time
    - `lines` object[]
      - `id` string
      - `npi` string
      - `kind` 'medicare_contractor' | 'medicaid_enrollment' | 'exclusion_sam'
      - `state` 'read' | 'needs_person' | 'not_covered'
      - `where` string: Two-letter state, or US.
      - `title` string
      - `summary` string: One plain sentence.
      - `tone` 'ok' | 'attention' | 'neutral'
      - `facts` object
      - `source` object
        - `name` string
        - `url` string
      - `read_at` string, date-time, nullable
      - `elapsed_ms` integer, nullable
      - `reason` string, nullable: Why it was not read automatically or needs a person; null when read.
      - `order` integer

## Other responses

- `400`: Send the email that sent the list and one valid NPI as JSON.
- `404`: Request not found for this email, or the NPI is not in this check.
- `410`: More than 24 hours after the list was sent.
- `413`: The request is over 2 KB.
- `429`: Too many requests from this address, or this check's limit is reached. See Retry-After.
- `503`: These records could not be read right now. Try again in a minute.

---

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