# HHS-OIG LEIE Exclusions Database Scraper (`crawlerbros/hhs-oig-leie-exclusions-scraper`) Actor

Scrape the HHS Office of Inspector General List of Excluded Individuals/Entities (LEIE) - the federal registry of health care providers and entities banned from Medicare, Medicaid, and other federal health programs. Search by name, NPI, state, specialty, or exclusion type. No API key required.

- **URL**: https://apify.com/crawlerbros/hhs-oig-leie-exclusions-scraper.md
- **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community)
- **Categories:** Automation, Agents, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## HHS-OIG LEIE Exclusions Database Scraper

Scrape the **HHS Office of Inspector General List of Excluded Individuals/Entities (LEIE)** — the official federal registry of health care providers, suppliers, and entities banned from participating in Medicare, Medicaid, and all other federal health care programs. Search the full current database by name, NPI, state, specialty, general category, or exclusion type, or pull a specific month's new exclusions and reinstatements. HTTP-only via HHS-OIG's official downloadable database. No login, no API key.

### What this actor does

- **Two modes:** `search` (the full current exclusions list) and `monthlyUpdates` (a specific month's new exclusions / reinstatements)
- **Rich filtering:** last/first/business name, NPI, UPIN, city, ZIP, state, general category, specialty, exclusion type
- **Finite dropdowns:** 58 states/territories, 87 general categories, 205 specialties, 22 statutory exclusion types
- **Both individuals and entities** — physicians, nurses, pharmacies, DME companies, home health agencies, and more
- **Empty fields are omitted**

### Output per record

- `name` — full name (individuals) or business name (entities)
- `isEntity` — `true` for a business/organization, `false` for a named individual
- `lastName`, `firstName`, `middleName` (individuals) / `businessName` (entities)
- `generalCategory` — broad HHS-OIG classification (e.g. `PHYSICIAN (MD, DO)`, `PHARMACY`, `HOME HEALTH AGENCY`)
- `specialty` — detailed specialty/occupation (e.g. `NURSE/NURSES AIDE`, `DME - OXYGEN`)
- `npi`, `upin` — provider identifiers, when on file
- `dateOfBirth` — individuals only, when on file
- `address`, `city`, `state`, `zip`
- `exclusionType` — statutory basis code (42 U.S.C. §1320a-7), e.g. `1128a1`, `1128b7`
- `exclusionDate` — when the exclusion took effect
- `reinstatementDate` — when the individual/entity was reinstated, if applicable
- `waiverDate`, `waiverState` — if a waiver was granted
- `supplementType` — `newExclusion` or `reinstatement` (mode=monthlyUpdates only)
- `sourceUrl`
- `recordType: "exclusion"`, `scrapedAt`

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | string | `search` | `search` (current database) / `monthlyUpdates` (one month's supplement) |
| `lastName` / `firstName` | string | – | Individual name filters (partial match) |
| `businessName` | string | – | Entity name filter (partial match) |
| `npi` / `upin` | string | – | Exact provider identifier |
| `city` | string | – | Partial match |
| `zip` | string | – | Exact 5-digit ZIP |
| `state` | string | – | One of 58 US states/territories |
| `generalCategory` | string | – | One of 87 HHS-OIG categories |
| `specialty` | string | – | One of 205 HHS-OIG specialties |
| `exclusionType` | string | – | One of 22 statutory exclusion type codes |
| `year` / `month` | int | – | Reporting month (mode=monthlyUpdates) |
| `listType` | string | `newExclusions` | `newExclusions` / `reinstatements` / `both` (mode=monthlyUpdates) |
| `maxItems` | int | `50` | Hard cap on emitted records (1–5000) |
| `proxyConfiguration` | object | Apify proxy | Optional automatic fallback if the HHS-OIG source rate-limits/blocks the datacenter IP |

#### Example: search by state and general category

```json
{
  "mode": "search",
  "state": "CA",
  "generalCategory": "PHARMACY",
  "maxItems": 50
}
````

#### Example: search by name

```json
{
  "mode": "search",
  "lastName": "Smith",
  "maxItems": 25
}
```

#### Example: search by NPI

```json
{
  "mode": "search",
  "npi": "1326440447"
}
```

#### Example: a specific month's new exclusions

```json
{
  "mode": "monthlyUpdates",
  "year": 2026,
  "month": "5",
  "listType": "newExclusions",
  "maxItems": 100
}
```

#### Example: a specific month's reinstatements

```json
{
  "mode": "monthlyUpdates",
  "year": 2026,
  "month": "5",
  "listType": "reinstatements"
}
```

### Use cases

- **Healthcare compliance** — screen employees, vendors, and contractors against the federal exclusion list before hiring/onboarding
- **Payer & TPA operations** — verify billing providers aren't excluded before processing claims
- **Background check platforms** — enrich screening reports with LEIE exclusion status
- **Healthcare M\&A due diligence** — check target-company personnel for exclusion history
- **Compliance monitoring** — track new exclusions and reinstatements each month by state or specialty

### FAQ

**What's the data source?** HHS-OIG's official downloadable LEIE database (`oig.hhs.gov/exclusions/downloadables/`), the same file used by every healthcare compliance program in the country. It's refreshed monthly.

**Is this official/affiliated with HHS-OIG?** No — this is a third-party actor built on HHS-OIG's own publicly downloadable database files.

**Why doesn't this actor use the online search form at exclusions.oig.hhs.gov?** That page is a legacy name-lookup tool capped at 5 names per search, with no filtering by NPI, state, specialty, or exclusion type. HHS-OIG's own guidance recommends the downloadable database for anything beyond a handful of one-off name checks — so that's what this actor uses, giving you every filter the online tool lacks.

**What's the difference between an individual and an entity record?** Individuals (physicians, nurses, etc.) have `lastName`/`firstName`; entities (pharmacies, DME companies, home health agencies) have only a `businessName`. The `isEntity` field tells you which.

**What do the exclusion type codes mean?** They cite the statutory basis under 42 U.S.C. §1320a-7 — e.g. `1128a1` is a conviction of a program-related crime (mandatory exclusion), `1128b4` is a license revocation (permissive exclusion). The dropdown shows the plain-English description for each code.

**How far back does `monthlyUpdates` go?** HHS-OIG keeps roughly the last 12-18 months of monthly supplement files live under a predictable URL. If you request an older month, the actor reports the actual available range in its status message — for historical data beyond that window, use `search` mode against the current full database instead.

**How fresh is the data?** The full database (`search` mode) is regenerated by HHS-OIG monthly. Monthly supplements are typically posted in the first two weeks of the following month.

**Does an exclusion ever expire on its own?** No — an excluded individual/entity remains excluded until formally reinstated by HHS-OIG (see `reinstatementDate`) or granted a waiver (see `waiverDate`/`waiverState`).

# Actor input Schema

## `mode` (type: `string`):

What to fetch.

## `lastName` (type: `string`):

Filter individuals by last name (partial match, case-insensitive).

## `firstName` (type: `string`):

Filter individuals by first name (partial match, case-insensitive).

## `businessName` (type: `string`):

Filter excluded entities (not individuals) by business name (partial match).

## `npi` (type: `string`):

Exact National Provider Identifier (10 digits).

## `upin` (type: `string`):

Exact legacy Unique Physician Identification Number.

## `city` (type: `string`):

Filter by city (partial match, case-insensitive).

## `zip` (type: `string`):

Exact 5-digit ZIP code.

## `state` (type: `string`):

US state/territory of the excluded individual or entity's address.

## `generalCategory` (type: `string`):

Broad provider/entity category as classified by HHS-OIG (e.g. Physician, Nursing Profession, Pharmacy).

## `specialty` (type: `string`):

Detailed specialty/occupation as classified by HHS-OIG.

## `exclusionType` (type: `string`):

Statutory basis for exclusion (42 U.S.C. §1320a-7).

## `year` (type: `integer`):

Year of the monthly supplement to fetch (mode=monthlyUpdates).

## `month` (type: `string`):

Month of the monthly supplement to fetch (mode=monthlyUpdates).

## `listType` (type: `string`):

Whether to fetch that month's new exclusions, reinstatements, or both.

## `maxItems` (type: `integer`):

Hard cap on emitted records.

## `proxyConfiguration` (type: `object`):

Optional. The HHS-OIG downloads are fully open; proxy is only used as an automatic fallback if the source ever rate-limits or blocks the datacenter IP.

## Actor input object example

```json
{
  "mode": "search",
  "state": "",
  "generalCategory": "",
  "specialty": "",
  "exclusionType": "",
  "listType": "newExclusions",
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `records` (type: `string`):

Dataset containing all scraped LEIE exclusion records.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "state": "",
    "generalCategory": "",
    "specialty": "",
    "exclusionType": "",
    "listType": "newExclusions",
    "maxItems": 50,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlerbros/hhs-oig-leie-exclusions-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "state": "",
    "generalCategory": "",
    "specialty": "",
    "exclusionType": "",
    "listType": "newExclusions",
    "maxItems": 50,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("crawlerbros/hhs-oig-leie-exclusions-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "state": "",
  "generalCategory": "",
  "specialty": "",
  "exclusionType": "",
  "listType": "newExclusions",
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call crawlerbros/hhs-oig-leie-exclusions-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=crawlerbros/hhs-oig-leie-exclusions-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "HHS-OIG LEIE Exclusions Database Scraper",
        "description": "Scrape the HHS Office of Inspector General List of Excluded Individuals/Entities (LEIE) - the federal registry of health care providers and entities banned from Medicare, Medicaid, and other federal health programs. Search by name, NPI, state, specialty, or exclusion type. No API key required.",
        "version": "1.0",
        "x-build-id": "pVWBvqrR7qApI0AQd"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/crawlerbros~hhs-oig-leie-exclusions-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-crawlerbros-hhs-oig-leie-exclusions-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/crawlerbros~hhs-oig-leie-exclusions-scraper/runs": {
            "post": {
                "operationId": "runs-sync-crawlerbros-hhs-oig-leie-exclusions-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/crawlerbros~hhs-oig-leie-exclusions-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-crawlerbros-hhs-oig-leie-exclusions-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "search",
                            "monthlyUpdates"
                        ],
                        "type": "string",
                        "description": "What to fetch.",
                        "default": "search"
                    },
                    "lastName": {
                        "title": "Last name",
                        "type": "string",
                        "description": "Filter individuals by last name (partial match, case-insensitive)."
                    },
                    "firstName": {
                        "title": "First name",
                        "type": "string",
                        "description": "Filter individuals by first name (partial match, case-insensitive)."
                    },
                    "businessName": {
                        "title": "Business / entity name",
                        "type": "string",
                        "description": "Filter excluded entities (not individuals) by business name (partial match)."
                    },
                    "npi": {
                        "title": "NPI",
                        "type": "string",
                        "description": "Exact National Provider Identifier (10 digits)."
                    },
                    "upin": {
                        "title": "UPIN",
                        "type": "string",
                        "description": "Exact legacy Unique Physician Identification Number."
                    },
                    "city": {
                        "title": "City",
                        "type": "string",
                        "description": "Filter by city (partial match, case-insensitive)."
                    },
                    "zip": {
                        "title": "ZIP code",
                        "type": "string",
                        "description": "Exact 5-digit ZIP code."
                    },
                    "state": {
                        "title": "State",
                        "enum": [
                            "",
                            "AK",
                            "AL",
                            "AR",
                            "AZ",
                            "CA",
                            "CO",
                            "CT",
                            "DC",
                            "DE",
                            "FL",
                            "FM",
                            "GA",
                            "GU",
                            "HI",
                            "IA",
                            "ID",
                            "IL",
                            "IN",
                            "KS",
                            "KY",
                            "LA",
                            "MA",
                            "MD",
                            "ME",
                            "MI",
                            "MN",
                            "MO",
                            "MP",
                            "MS",
                            "MT",
                            "NC",
                            "ND",
                            "NE",
                            "NH",
                            "NJ",
                            "NM",
                            "NV",
                            "NY",
                            "OH",
                            "OK",
                            "OR",
                            "PA",
                            "PR",
                            "RI",
                            "SC",
                            "SD",
                            "TN",
                            "TX",
                            "UT",
                            "VA",
                            "VI",
                            "VT",
                            "WA",
                            "WI",
                            "WV",
                            "WY",
                            "XX"
                        ],
                        "type": "string",
                        "description": "US state/territory of the excluded individual or entity's address.",
                        "default": ""
                    },
                    "generalCategory": {
                        "title": "General category",
                        "enum": [
                            "",
                            "ACCOUNTING FIRM",
                            "ACUPUNCTURIST",
                            "ADULT HOME",
                            "AMBLNTRY SRGCL CNTR",
                            "AMBULANCE COMPANY",
                            "AUDIOLOGIST",
                            "BILLING SERVICE CO",
                            "BOARDING HOME",
                            "BUS OWNER/EXEC",
                            "CARRIER/INTERMEDIARY",
                            "CHIROPRACTIC PRACT",
                            "CLINIC",
                            "COMM MNTL HLTH CNTR",
                            "CONSULTING FIRM",
                            "COUNSELING CENTER",
                            "DENTAL PRACTICE",
                            "DME COMPANY",
                            "DOCTOR OWNED ENTITY",
                            "DRUG COMPANY/SUPLIER",
                            "ELECTED OFFICIAL",
                            "EMPLOYEE - FEDERAL -",
                            "EMPLOYEE - HHS",
                            "EMPLOYEE - PRIVATE S",
                            "EMPLOYEE - ST/LOC/TR",
                            "EMPLOYEE-GOVERNMENT",
                            "FISCAL AGENT",
                            "GOVERNMENT CONTRACTO",
                            "GOVERNMENT GRANTEE",
                            "GOVT EMP(STATE/LOC)",
                            "GOVT EMPLOYEE(FED)",
                            "HC CONGLOM - PARENT",
                            "HEALTH MAINT ORG",
                            "HHS EMPLOYEE",
                            "HHS EMPLOYEE-AOA",
                            "HHS EMPLOYEE-IHS",
                            "HHS EMPLOYEE-PHS",
                            "HOME HEALTH AGENCY",
                            "HOSPICE",
                            "HOSPITAL",
                            "IND- LIC HC SERV PRO",
                            "INDIVIDUAL (UNAFFILI",
                            "INSURANCE COMPANY",
                            "INTER CARE FACILITY",
                            "INTERPRETER/TRANS",
                            "LABORATORY",
                            "LAW PRACTICE",
                            "MANAGEMENT SVCS CO",
                            "MANUF/LESSOR SUPP/EQ",
                            "MEDICAL GROUP",
                            "MEDICAL PRACTICE, MD",
                            "MENTAL HEALTH FAC",
                            "NURSING FIRM",
                            "NURSING PROFESSION",
                            "OPTICAL PRACTICE",
                            "OPTOMETRIC PRACTICE",
                            "ORTHOTIST/PROSTHETIS",
                            "OSTEOPATHIC PRAC",
                            "OTHER BUSINESS",
                            "OWNER/EXEC-GOVT CONT",
                            "OWNER/EXEC-GOVT GRAN",
                            "PHARMACY",
                            "PHYSICAL THERAPIST",
                            "PHYSICIAN (MD, DO)",
                            "PHYSICIAN ASSISTANT",
                            "PHYSICIAN PRACTICE (",
                            "PODIATRY PRACTICE",
                            "PRINTING FIRM",
                            "PRIVATE CIT/ENTITY",
                            "PSYCHOLOGIC PRACTICE",
                            "PUBLIC OFFICE",
                            "RADIOLOGY FACILITY",
                            "RECIPT/BENEFICIARY",
                            "REGULATED INDTRY REP",
                            "REHAB FACILITY - GEN",
                            "RENAL FACILITY",
                            "RENAL PROV-HOSPITAL",
                            "REPRESENTATIVE PAYEE",
                            "RESEARCHER",
                            "RURAL HEALTH CLINIC",
                            "SKILLED NURSING FAC",
                            "STATE/LOCAL/TRIBAL A",
                            "SUBCONTRACTING CO",
                            "THERAPIST",
                            "THERAPUDIC CLINIC",
                            "TRANSPORTATION CO",
                            "TRIBAL ORGANIZATION",
                            "UNIVERSITY/COLLEGE"
                        ],
                        "type": "string",
                        "description": "Broad provider/entity category as classified by HHS-OIG (e.g. Physician, Nursing Profession, Pharmacy).",
                        "default": ""
                    },
                    "specialty": {
                        "title": "Specialty",
                        "enum": [
                            "",
                            "ACCOUNT/BOOKKPR/AUDI",
                            "ACCOUNTABLE CARE ORG",
                            "ACCOUNTING FIRM",
                            "ACF",
                            "ACL",
                            "ACUPUNCTURE PRACTICE",
                            "ACUPUNCTURIST",
                            "ADMINISTRATOR",
                            "ADULT DAY CARE FACIL",
                            "ADULT HOME",
                            "AHRQ",
                            "ALLERGIST/IMMUNOLOGY",
                            "ALLIED HEALTH RELATE",
                            "AMBLNTRY SRGCL CNTR",
                            "AMBULANCE COMPANY",
                            "ANESTHESIOLOGY",
                            "ANESTHETIST",
                            "ARCHITECT/ENGINEER",
                            "ASSISTED LIVING FACI",
                            "AUDIOLOGY",
                            "AUDIOLOGY PRACTICE",
                            "BILLING SERVICE CO",
                            "BOARDING HOME",
                            "BUSINESS MANAGER",
                            "CARDIOLOGY",
                            "CHECK CASHING STORE",
                            "CHIROPRACTIC",
                            "CHIROPRACTIC PRACT",
                            "CLERK/OTHER CLERICAL",
                            "CLINIC",
                            "CMS",
                            "COMM MNTL HLTH CNTR",
                            "COMMUNITY HLTH CTR (",
                            "COMPTROLLER",
                            "COMPUTER RELATED",
                            "CONSULTANT",
                            "CONSULTING FIRM",
                            "CONTRACTING OFFICER",
                            "CONTRACTOR",
                            "COUNSELING CENTER",
                            "COUNSELOR",
                            "DENTAL HYGIENIST",
                            "DENTAL PRACTICE",
                            "DENTIST",
                            "DERMATOLOGY",
                            "DME - DIABETIC SUPPL",
                            "DME - DIETARY SUPPLI",
                            "DME - GENERAL",
                            "DME - HEARING AID",
                            "DME - HOME INFUSION",
                            "DME - INCONTINENCE K",
                            "DME - LYMPHEDEMA PUM",
                            "DME - ORTHOTICS",
                            "DME - OXYGEN",
                            "DME - POWER VEHICLES",
                            "DME - PROSTHETICS",
                            "DME - TELEMARKETING",
                            "DME - TENS",
                            "DME - UROLOGICAL SUP",
                            "DME - WOUND CARE KIT",
                            "DMERC",
                            "DRUG COMPANY/SUPLIER",
                            "EMERGENCY MED TECH",
                            "EMERGENCY MEDICINE",
                            "EMPLOYEE",
                            "EMPLOYEE - 14 & BELO",
                            "EMPLOYEE - GM/GS-15",
                            "EMPLOYEE - GRADE UNK",
                            "EMPLOYEE - MILITARY",
                            "EMPLOYEE - WAGE GRAD",
                            "ENDOCRINOLOGY",
                            "FAMILY PRACTICE",
                            "FOSTER CARE PROVIDER",
                            "GASTROENTEROLOGY",
                            "GENERAL PRACTICE",
                            "GENERAL PRACTICE/FP",
                            "GENETICS",
                            "GERONTOLOGY",
                            "GOV'T INSUR RECIPIEN",
                            "GRANTEE",
                            "GS 1-12",
                            "GYN/OBS",
                            "HC CONGLOM - PARENT",
                            "HEALTH CARE AIDE",
                            "HEALTH MAINT ORG",
                            "HEMATOLOGY",
                            "HOME HEALTH AGENCY",
                            "HOSPICE",
                            "HOSPITAL",
                            "HOTEL/LODGING",
                            "HRSA",
                            "IHS",
                            "INFECTIOUS DISEASE",
                            "INFUSION THERAPY CLI",
                            "INSURANCE COMPANY",
                            "INTER CARE FACILITY",
                            "INTERNAL MEDICINE",
                            "INTERPRETER/TRANS",
                            "LAB - CLINICAL",
                            "LAB-NON-INVASIV VASC",
                            "LAB-PHYSICIAN OWNED",
                            "LABORATORY",
                            "LABORATORY-IDTF",
                            "LABORER",
                            "LAW PRACTICE",
                            "LAWYER",
                            "LICENSED PRACTITIONE",
                            "LOAN RECIPIENT",
                            "LOCAL GOV'T",
                            "MANAGEMENT SVCS CO",
                            "MANUF/LESSOR SUPP/EQ",
                            "MARKETING FIRM",
                            "MEDICAID MANAGED CAR",
                            "MEDICARE ADV CONTR (",
                            "MEDICARE PART D CONT",
                            "MENTAL/BEHAVIORAL HE",
                            "MULTI-SPECIALTY",
                            "NATUROPATHY",
                            "NEPHROLOGY",
                            "NEUROLOGY",
                            "NIH",
                            "NO KNOWN AFFILIATION",
                            "NON-PROFIT ORGANIZAT",
                            "NURSE PRACTITIONER (",
                            "NURSE/NURSES AIDE",
                            "NURSING FIRM",
                            "OFFICER/EXECUT/BOARD",
                            "ONCOLOGY",
                            "OPHTHALMOLOGY",
                            "OPTICAL PRACTICE",
                            "OPTICIAN",
                            "OPTOMETRIC PRACTICE",
                            "OPTOMETRY",
                            "ORTHOPEDICS",
                            "ORTHOTIST/PROSTHETIS",
                            "OSTEOPATHY",
                            "OTHER CONTRACTOR",
                            "OTHER FEDERAL AGENCY",
                            "OTHERS",
                            "OTORHINOLARYNGOLOGY",
                            "OWNER",
                            "OWNER/OPERATOR",
                            "PAIN MANAGEMENT",
                            "PAIN MGMT/PHYSIATRIS",
                            "PARAMEDIC TECHNICIAN",
                            "PARENT CHLD SUP ENF",
                            "PATHOLOGY",
                            "PEDIATRICS",
                            "PERSONAL CARE PROVID",
                            "PHARMACIST",
                            "PHARMACY",
                            "PHARMACY BENEFIT MAN",
                            "PHARMACY TECHNICIAN",
                            "PHLEBOTOMY",
                            "PHYS THERAPY PROVIDE",
                            "PHYS/DENT/HEAL/PROVI",
                            "PHYSICAL THERAPY",
                            "PHYSICIAN ASSISTANT",
                            "PHYSICIAN PRACTICE (",
                            "PLASTIC SURGERY",
                            "PODIATRY",
                            "PODIATRY PRACTICE",
                            "PRINTING FIRM",
                            "PRIVATE CITIZEN",
                            "PROCTOLOGY",
                            "PSYCHIATRY",
                            "PSYCHOLOGIC PRACTICE",
                            "PSYCHOLOGY",
                            "PUBLIC ASSIST. RCPT.",
                            "PULMONOLOGY",
                            "RADIOLOGY",
                            "RADIOLOGY FACILITY",
                            "RECIPT/BENEFICIARY",
                            "RECRUITER/CAPPER",
                            "REGULATED INDUSTRY",
                            "REHAB FACILITY - GEN",
                            "RELATED",
                            "RENAL FACILITY",
                            "REPRESENTATIVE PAYEE",
                            "RESEARCH COMPANY",
                            "RHEUMATOLOGY",
                            "RSRCH SCNTST-EMPLYEE",
                            "RURAL HEALTH CLINIC",
                            "SALES/MARKET/RETAIL",
                            "SAMHSA",
                            "SECUR OFFICER/GUARD",
                            "SKILLED NURSING FAC",
                            "SOBER HOME",
                            "SOCIAL WORKER",
                            "STATE GOV'T",
                            "SUBCONTRACTOR",
                            "SUBCONTRACTOR (NON-H",
                            "SUBSTANCE ABUSE REHA",
                            "SUPERVISOR/FOREMAN",
                            "SURGERY",
                            "TEACHER",
                            "TECHNICIAN",
                            "THERAPEUTIC BOARDING",
                            "THERAPIST",
                            "TRANSPORTATION CO",
                            "TRIBAL AGENCY",
                            "UNEMPLOYED",
                            "UNIVERSITY/COLLEGE",
                            "UROLOGY",
                            "VENDOR"
                        ],
                        "type": "string",
                        "description": "Detailed specialty/occupation as classified by HHS-OIG.",
                        "default": ""
                    },
                    "exclusionType": {
                        "title": "Exclusion type",
                        "enum": [
                            "",
                            "1128Aa",
                            "1128a1",
                            "1128a2",
                            "1128a3",
                            "1128a4",
                            "1128b1",
                            "1128b11",
                            "1128b12",
                            "1128b14",
                            "1128b15",
                            "1128b16",
                            "1128b2",
                            "1128b3",
                            "1128b4",
                            "1128b5",
                            "1128b6",
                            "1128b7",
                            "1128b8",
                            "1156",
                            "1160",
                            "BRCH CIA",
                            "BRCH SA"
                        ],
                        "type": "string",
                        "description": "Statutory basis for exclusion (42 U.S.C. §1320a-7).",
                        "default": ""
                    },
                    "year": {
                        "title": "Year (mode=monthlyUpdates)",
                        "minimum": 1999,
                        "maximum": 2030,
                        "type": "integer",
                        "description": "Year of the monthly supplement to fetch (mode=monthlyUpdates)."
                    },
                    "month": {
                        "title": "Month (mode=monthlyUpdates)",
                        "enum": [
                            "1",
                            "2",
                            "3",
                            "4",
                            "5",
                            "6",
                            "7",
                            "8",
                            "9",
                            "10",
                            "11",
                            "12"
                        ],
                        "type": "string",
                        "description": "Month of the monthly supplement to fetch (mode=monthlyUpdates)."
                    },
                    "listType": {
                        "title": "Supplement list type (mode=monthlyUpdates)",
                        "enum": [
                            "newExclusions",
                            "reinstatements",
                            "both"
                        ],
                        "type": "string",
                        "description": "Whether to fetch that month's new exclusions, reinstatements, or both.",
                        "default": "newExclusions"
                    },
                    "maxItems": {
                        "title": "Max items",
                        "minimum": 1,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "Hard cap on emitted records.",
                        "default": 50
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Optional. The HHS-OIG downloads are fully open; proxy is only used as an automatic fallback if the source ever rate-limits or blocks the datacenter IP.",
                        "default": {
                            "useApifyProxy": true
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
