{"slug":"api-flipvo-com-v1-exclusions-screen-dbd03b","title":"Screens a person or business name, or an NPI, against the HHS-OIG exclusion list","host":"api.flipvo.com","method":"POST","resource":"https://api.flipvo.com/v1/exclusions/screen","category":"code","description":"Screens a person or business name, or an NPI, against the HHS-OIG exclusion list (LEIE, Medicare and Medicaid): potential matches only, each with name score, reasons, NPI, state, specialty, exclusion type and date. Not a determination: confirm a match on the OIG online search with the SSN or EIN. Em","price_listed":0.01,"price_asked":0.01,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":772,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"name":"Future Pharmacy","state":"PA"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"description":"A name or an NPI to screen; state only adds a reason and re-ranks.","properties":{"limit":{"default":10,"maximum":25,"minimum":1,"title":"Limit","type":"integer"},"lists":{"anyOf":[{"items":{"const":"leie","type":"string"},"minItems":1,"type":"array"},{"type":"null"}],"default":null,"description":"Lists to screen. Default: every loaded list.","title":"Lists"},"min_score":{"default":85,"description":"Name score floor, 70-100.","maximum":100,"minimum":70,"title":"Min Score","type":"integer"},"name":{"anyOf":[{"maxLength":200,"minLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"A person or a business. Required unless npi is given.","examples":["Future Pharmacy"],"title":"Name"},"npi":{"anyOf":[{"pattern":"^[0-9]{10}$","type":"string"},{"type":"null"}],"default":null,"description":"10-digit National Provider Identifier: an exact key.","examples":["1528216520"],"title":"Npi"},"state":{"anyOf":[{"maxLength":2,"minLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"US state or territory code: a match ranks a candidate higher.","examples":["PA"],"title":"State"}},"title":"ExclusionsScreenRequest","type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"candidates":{"items":{"properties":{"exclusion_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"title":"Exclusion Date"},"exclusion_type":{"title":"Exclusion Type","type":"string"},"general":{"title":"General","type":"string"},"kind":{"enum":["person","entity"],"title":"Kind","type":"string"},"list":{"const":"leie","title":"List","type":"string"},"name":{"title":"Name","type":"string"},"npi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Npi"},"reasons":{"items":{"enum":["exact_name","fuzzy_name","name_without_middle","name_cut_at_30","npi","state"],"type":"string"},"title":"Reasons","type":"array"},"score":{"title":"Score","type":"integer"},"specialty":{"title":"Specialty","type":"string"},"state":{"title":"State","type":"string"},"waiver_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"title":"Waiver Date"},"waiver_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Waiver State"}},"required":["list","name","kind","score","reasons","npi","state","general","specialty","exclusion_type","exclusion_date","waiver_date","waiver_state"],"title":"ExclusionsCandidate","type":"object"},"title":"Candidates","type":"array"},"coverage":{"title":"Coverage","type":"string"},"data_as_of":{"title":"Data As Of","type":"string"},"source":{"title":"Source","type":"string"},"total_candidates":{"title":"Total Candidates","type":"integer"},"truncated":{"title":"Truncated","type":"boolean"}},"required":["candidates","total_candidates","truncated","data_as_of","coverage","source"],"title":"ExclusionsScreenResponse","type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-01","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.01,"price_match":true,"latency_ms":772,"error":null}],"description_full":"Screens a person or business name, or an NPI, against the HHS-OIG exclusion list (LEIE, Medicare and Medicaid): potential matches only, each with name score, reasons, NPI, state, specialty, exclusion type and date. Not a determination: confirm a match on the OIG online search with the SSN or EIN. Empty candidates is a paid 200. Not for employment or credit decisions. List dates and code meanings: GET /v1/exclusions/lists (free).","last_updated":"2026-10-01T05:10:07.364Z","schemes":["exact"]}