Drugs and formularies
excluded_prescriber_payment_screen
Excluded Prescriber Payment Screen·v1.2.0·L2·read-only·MCP + REST·admitted 2026-09-19
Inputs
41 required
Sources
3
Known limits
2
Real answer
4.88scomplete
What it answers
- 1Given an NPI (10-digit), returns OIG LEIE exclusion status and — if excluded — any Open Payments received OR Part D prescribing activity recorded AFTER the exclusion date (and before any reinstatement).
- 2The textbook qui-tam / False Claims Act screening query.
- 3Bridges three substrate sources: dim_oig_leie (LEIE), fact_drug_payment_to_prescriber (Open Payments), fact_part_d_prescriber (Part D Prescriber-by-Drug).
- 4Returns: total post-exclusion payment dollars + Part D drug-cost exposure, broken down by year + top 5 manufacturers.
- 5Every answer carries an explicit exclusion_status (not_in_leie, excluded, or excluded_then_reinstated) beside the dollars, so a $0 result is never ambiguous: a not-in-LEIE NPI returns zero ANCHORED to the LEIE snapshot date it was checked against (leie_asserted_at), which is a different thing from an excluded prescriber who drew no post-exclusion payments.
- 6KNOWN GAPS: open_payments_publication_lag_one_year (current PY publishes June+1); part_d_puf_annual_grain_only (Part D PUF is annual not monthly — finer-grain timing requires claims data).
- 7LEIE refreshes monthly per the M-6 schedule (cycle 2).
Inputs (4)
| Name | Type | Required | Default | Accepts |
|---|---|---|---|---|
npi | string | required | ||
acknowledge_era_break | boolean | optional | false | |
op_lookback_years | integer | optional | 10 | |
pdp_lookback_years | integer | optional | 10 |
Call it
# MCP (https://mcp.vladahealth.com/mcp): the tool by name excluded_prescriber_payment_screen(npi="1447200742")
curl -X POST https://api.vladahealth.com/v1/tools/excluded_prescriber_payment_screen \
-H "Authorization: Bearer $VLADA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"npi":"1447200742"}'
# the schema, no key
curl https://api.vladahealth.com/v1/tools/excluded_prescriber_payment_screen/schemaA real answer
customer seat, 2026-11-09·over REST·4.88s·status
complete·complete·verbatim{
"value": {
"headline": 0.0,
"npi": "1447200742",
"npi_query": "1447200742",
"is_excluded": false,
"exclusion_status": "not_in_leie",
"leie_asserted_at": "2026-11-04",
"exclusion_record": null,
"post_exclusion_payments_total_usd": 0.0,
"post_exclusion_payments_count": 0,
"post_exclusion_pdp_total_drug_cost_usd": 0.0,
"post_exclusion_pdp_total_claims": 0,
"payments_by_year": [],
"top_manufacturers": [],
"zero_basis": "no LEIE exclusion for this NPI, so no post-exclusion window exists to measure payments or prescribing in. The zero is by construction, not an empty read."
},
"unit": "USD",
"result_status": "answered",
"methodology_era": {
"era_name": "leie_monthly_refresh_post_2026_05_16",
"era_start": "2026-05-16",
"era_end": "2099-12-31"
},
"methodology_blend_factors": null,
"source": {
"source_url": "medicare://excluded_prescriber_payment_screen"
},
"vintage": "as_restated",
"cms_vintage_sequence": 1,
"parse_revision": 1,
"as_of_observed": null,
"as_of_asserted": null,
"as_of_effective": null,
"caveats": [],
"confidence": null,
"finality_confidence": null,
"response_hash": "9a47b7708ff85a59ab1811fe59bfb05d00f26855a2386855b1a24c87b86c0525",
"semantic_version": 1,
"tool_version": "1.2.0",
"parser_artifact_hash": "0b11193fb97519397f53ffe2917938b1bf95f408fccb5bae6d356b17ef22a148",
"parser_artifact_hash_basis": "tool_source_sha256",
"signature": null,
"tenant_id": "probe-customer-canary",
"status": "complete",
"audit_id": "c6207f25-b076-429f-94bc-ea5be4ea24d6",
"timestamp": "2026-11-09T21:37:51.340868Z",
"request_id": "7c67bcbf-05bb-4c4f-bc2b-6f7266e60af2",
"audience": "customer",
"answer": {
"value": 0.0,
"value_ref": "value",
"unit": "USD",
"scope": {
"tool": "excluded_prescriber_payment_screen",
"filters": {
"npi": "1447200742"
}
}
},
"method": "Read from the CMS publication. The published values are reported as published, with no adjustment or modelling applied.",
"evidence": {
"response_hash": "9a47b7708ff85a59ab1811fe59bfb05d00f26855a2386855b1a24c87b86c0525",
"audit_id": "c6207f25-b076-429f-94bc-ea5be4ea24d6",
"request_id": "7c67bcbf-05bb-4c4f-bc2b-6f7266e60af2"
}
}What comes back
| Field | Holds |
|---|---|
status | complete · partial · refused · failed · queued |
value | rows or the figure, with its unit |
source · caveats · invariants_applied · response_hash | the public file and vintage; what to know before citing; the rules honoured; replayable |
refusal | code (15), message, recover_with |
Sources
| Kind | Name |
|---|---|
| source | drug_silver.dim_oig_leie |
| source | drug_silver.fact_drug_payment_to_prescriber |
| source | drug_silver.fact_part_d_prescriber |
| table | drug_silver.dim_oig_leie |
| table | drug_silver.fact_drug_payment_to_prescriber |
| table | drug_silver.fact_part_d_prescriber |
Known limits (2)
- 1open_payments_publication_lag_one_year
- 2part_d_puf_annual_grain_only
This page as markdown: /docs-md/tools/excluded_prescriber_payment_screen.md · every page in one file: /llms-full.txt