Screen a name against the OIG exclusion list (LEIE)
screen_exclusionScreens one person or business name against a mirrored copy of the HHS-OIG List of Excluded Individuals/Entities (LEIE), the list of people and businesses excluded from Medicare, Medicaid and other federal health care programs. Person names match in any word order, with or without middle names or initials, suffixes (Jr, Sr, III), credentials (MD, RN), punctuation, hyphenated surnames, common nicknames and one-letter typos; business names match without company-form words (LLC, Inc, PC) and with abbreviations and small typos. Returns ranked possible matches with score, name, general category and specialty, city, state, ZIP, NPI when present, exclusion type with its meaning, exclusion date and any waiver, or a no-match result at the threshold, plus the list's as-of date. Optional state, NPI and date-of-birth filters narrow common names.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dob | No | Optional date of birth, YYYY-MM-DD. Used only to report whether it matches each record ("matches", or "no DOB on file"); records whose date of birth does not match are left out and counted. The date is not stored, and stored dates of birth are never returned. | |
| npi | No | Optional 10-digit National Provider Identifier. Records with a different NPI are left out and counted; records without an NPI (most of the list) are kept. | |
| name | Yes | Person ("Jane Q. Doe", "Doe, Jane", "Jane Doe RN") or business ("Acme Home Health LLC") to screen. | |
| type | No | Optional: "individual" for a person, "entity" for a business. Default: both. | |
| limit | No | Maximum number of matches to return, 1 to 25 (default 5). | |
| state | No | Optional U.S. state filter: two-letter code ("OH") or name ("Ohio"). Records in other states are left out and counted; records with no state are kept. The LEIE address is the one at the time of exclusion. | |
| detail | No | "summary" (default) returns the key fields; "full" adds UPIN, the exclusion kind and minimum period, and the middle-name comparison. | summary |
| min_score | No | Similarity threshold from 0.5 to 1.0 (default 0.85). 1.0 = same first and last name (or business name) after normalization; lower values return weaker possible matches. |