Pay-per-call US healthcare data: hospital financials, prices, quality, exclusions, wages.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
CMS Care Compare quality record by CCN for a dialysis. Answers: what are the quality ratings and performance measures for this facility? Source: CMS Care Compare. [price: $0.01/call]
Path parameter: CMS Certification Number
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
CMS Care Compare quality record by CCN for a dialysis. Answers: what are the quality ratings and performance measures for this facility? Source: CMS Care Compare. [price: $0.01/call]
| Argument | Type | Description |
|---|---|---|
| ccn* | string | Path parameter: CMS Certification Number |
{
"type": "object",
"required": [
"ccn"
],
"properties": {
"ccn": {
"type": "string",
"description": "Path parameter: CMS Certification Number"
}
}
}Search dialysis quality data by state, city, ZIP, or CMS star rating. Answers: which dialysis meet quality thresholds in a market? Source: CMS Care Compare, monthly refresh. [price: $0.02/call]
| Argument | Type | Description |
|---|---|---|
| city | string | |
| limit | integer | |
| state | string | |
| offset | integer | |
| rating_max | number | |
| rating_min | number | |
| zip_prefix | string |
{
"type": "object",
"properties": {
"city": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string"
},
"offset": {
"type": "integer",
"default": 0
},
"rating_max": {
"type": "number"
},
"rating_min": {
"type": "number"
},
"zip_prefix": {
"type": "string"
}
}
}CMS Care Compare quality record by CCN for a home health. Answers: what are the quality ratings and performance measures for this facility? Source: CMS Care Compare. [price: $0.01/call]
| Argument | Type | Description |
|---|---|---|
| ccn* | string | Path parameter: CMS Certification Number |
{
"type": "object",
"required": [
"ccn"
],
"properties": {
"ccn": {
"type": "string",
"description": "Path parameter: CMS Certification Number"
}
}
}Search home health quality data by state, city, ZIP, or CMS star rating. Answers: which home health meet quality thresholds in a market? Source: CMS Care Compare, monthly refresh. [price: $0.02/call]
| Argument | Type | Description |
|---|---|---|
| city | string | |
| limit | integer | |
| state | string | |
| offset | integer | |
| rating_max | number | |
| rating_min | number | |
| zip_prefix | string |
{
"type": "object",
"properties": {
"city": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string"
},
"offset": {
"type": "integer",
"default": 0
},
"rating_max": {
"type": "number"
},
"rating_min": {
"type": "number"
},
"zip_prefix": {
"type": "string"
}
}
}CMS Care Compare quality record by CCN for a hospice. Answers: what are the quality ratings and performance measures for this facility? Source: CMS Care Compare. [price: $0.01/call]
| Argument | Type | Description |
|---|---|---|
| ccn* | string | Path parameter: CMS Certification Number |
{
"type": "object",
"required": [
"ccn"
],
"properties": {
"ccn": {
"type": "string",
"description": "Path parameter: CMS Certification Number"
}
}
}Search hospice quality data by state, city, ZIP, or CMS star rating. Answers: which hospice meet quality thresholds in a market? Source: CMS Care Compare, monthly refresh. [price: $0.02/call]
| Argument | Type | Description |
|---|---|---|
| city | string | |
| limit | integer | |
| state | string | |
| offset | integer | |
| rating_max | number | |
| rating_min | number | |
| zip_prefix | string |
{
"type": "object",
"properties": {
"city": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string"
},
"offset": {
"type": "integer",
"default": 0
},
"rating_max": {
"type": "number"
},
"rating_min": {
"type": "number"
},
"zip_prefix": {
"type": "string"
}
}
}CMS Care Compare quality record by CCN for a hospitals. Answers: what are the quality ratings and performance measures for this facility? Source: CMS Care Compare. [price: $0.01/call]
| Argument | Type | Description |
|---|---|---|
| ccn* | string | Path parameter: CMS Certification Number |
{
"type": "object",
"required": [
"ccn"
],
"properties": {
"ccn": {
"type": "string",
"description": "Path parameter: CMS Certification Number"
}
}
}Search hospitals quality data by state, city, ZIP, or CMS star rating. Answers: which hospitals meet quality thresholds in a market? Source: CMS Care Compare, monthly refresh. [price: $0.02/call]
| Argument | Type | Description |
|---|---|---|
| city | string | |
| limit | integer | |
| state | string | |
| offset | integer | |
| zip_prefix | string | |
| overall_rating_max | number | |
| overall_rating_min | number |
{
"type": "object",
"properties": {
"city": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string"
},
"offset": {
"type": "integer",
"default": 0
},
"zip_prefix": {
"type": "string"
},
"overall_rating_max": {
"type": "number"
},
"overall_rating_min": {
"type": "number"
}
}
}CMS Care Compare quality record by CCN for a snf. Answers: what are the quality ratings and performance measures for this facility? Source: CMS Care Compare. [price: $0.01/call]
| Argument | Type | Description |
|---|---|---|
| ccn* | string | Path parameter: CMS Certification Number |
{
"type": "object",
"required": [
"ccn"
],
"properties": {
"ccn": {
"type": "string",
"description": "Path parameter: CMS Certification Number"
}
}
}Search snf quality data by state, city, ZIP, or CMS star rating. Answers: which snf meet quality thresholds in a market? Source: CMS Care Compare, monthly refresh. [price: $0.02/call]
| Argument | Type | Description |
|---|---|---|
| city | string | |
| limit | integer | |
| state | string | |
| offset | integer | |
| zip_prefix | string | |
| overall_rating_max | number | |
| overall_rating_min | number |
{
"type": "object",
"properties": {
"city": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string"
},
"offset": {
"type": "integer",
"default": 0
},
"zip_prefix": {
"type": "string"
},
"overall_rating_max": {
"type": "number"
},
"overall_rating_min": {
"type": "number"
}
}
}Search ambulatory surgical centers (ASCs) by state, CCN, or name. Answers: which ASCs are in a given market? Source: CMS ASC cost data. [price: $0.02/call]
| Argument | Type | Description |
|---|---|---|
| ccn | string | |
| limit | integer | |
| state | string | |
| offset | integer | |
| name_search | string |
{
"type": "object",
"properties": {
"ccn": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string"
},
"offset": {
"type": "integer",
"default": 0
},
"name_search": {
"type": "string"
}
}
}Hospital cost-report record by CMS Certification Number (CCN). Answers: what are the financial and operational metrics for this hospital across fiscal years? Includes identity, beds, discharges, revenues, net income, operating margin. [price: $0.01/call]
| Argument | Type | Description |
|---|---|---|
| ccn* | string | Path parameter: CMS Certification Number |
{
"type": "object",
"required": [
"ccn"
],
"properties": {
"ccn": {
"type": "string",
"description": "Path parameter: CMS Certification Number"
}
}
}Multi-year financial history for one hospital by CCN: beds, discharges, revenues, net income per fiscal year, up to 15 years. Source: CMS cost reports. [price: $0.05/call]
| Argument | Type | Description |
|---|---|---|
| ccn* | string | Path parameter: CMS Certification Number |
{
"type": "object",
"required": [
"ccn"
],
"properties": {
"ccn": {
"type": "string",
"description": "Path parameter: CMS Certification Number"
}
}
}Search US hospitals by state, city, type, control, beds, discharges, revenues, or operating margin. Answers: which hospitals in a market match a financial or operational profile? Source: CMS cost reports (HCRIS 2552-10). [price: $0.02/call]
| Argument | Type | Description |
|---|---|---|
| city | string | |
| limit | integer | |
| state | string | |
| offset | integer | |
| zip_prefix | string | |
| fy_end_year | integer | |
| name_search | string | |
| control_type | string | |
| hospital_type | string | |
| total_beds_max | number | |
| total_beds_min | number | |
Search Medicare providers by NPI, state, specialty, service volume, beneficiaries, or payments. Answers: which providers in a market match this specialty, volume, or beneficiary profile? Source: CMS Medicare claims. [price: $0.02/call]
| Argument | Type | Description |
|---|---|---|
| npi | string | |
| limit | integer | |
| state | string | |
| offset | integer | |
| specialty | string | |
| total_payment_max | number | |
| total_payment_min | number | |
| total_services_max | number | |
| total_services_min | number | |
| total_beneficiaries_max | number | |
| total_beneficiaries_min | number |
Hospital capital-expenditure jump signals from CMS cost reports (Worksheet A-7): hospitals whose major movable equipment purchases hit at least $1M and at least 2x the prior fiscal year — an observational marker that a hospital reported a step-up in equipment spend. Answers: which hospitals just bought equipment? Includes purchase dollars by asset class and the prior-year comparison. Filter by state, min_amount (movable-equipment dollars), since; keyset cursor pagination. [price: $0.1/call]
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| since | string | only events on/after this date (YYYY-MM-DD) |
| state | string | 2-letter state code(s), comma-separated |
| cursor | string | opaque next_cursor from the previous page |
| min_amount | number | minimum movable-equipment purchase dollars in the trigger year |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100
},
"since": {
"type": "string",
"format": "date",
"description": "only events on/after this date (YYYY-MM-DD)"
},
"state": {
"type": "string",
"description": "2-letter state code(s), comma-separated"
},
"cursor": {
"type": "string",
"description": "opaque next_cursor from the previous page"
},
"min_amount": {
"type": "number",
"description": "minimum movable-equipment purchase dollars in the trigger year"
}
}
}National price statistics for a billing code (CPT/HCPCS/MS-DRG) from hospital price-transparency files: median and spread of payer-negotiated rates. Answers: what is a fair price for this procedure? Shape varies: a code under one billing_code_type (common case) returns the flat row shown below; a code ambiguous across types instead returns { billing_code, stats_by_type: [...] } — check for a top-level stats_by_type array to tell them apart. [price: $0.005/call]
| Argument | Type | Description |
|---|---|---|
| code* | string | Path parameter: billing code (CPT/HCPCS/MS-DRG) |
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"description": "Path parameter: billing code (CPT/HCPCS/MS-DRG)"
}
}
}Search hospital price-transparency negotiated rates by billing code (CPT/HCPCS/MS-DRG), state, payer, hospital CCN, or rate type. Answers: what do payers actually pay for this procedure at these hospitals? Source: hospital-published MRFs. [price: $0.03/call]
| Argument | Type | Description |
|---|---|---|
| ccn | string | |
| limit | integer | |
| payer | string | |
| state | string | |
| offset | integer | |
| rate_type | string | |
| billing_code | string | |
| billing_code_type | string |
{
"type": "object",
"properties": {
"ccn": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"payer": {
"type": "string"
},
"state": {
"type": "string"
},
"offset": {
"type": "integer",
"default": 0
},
"rate_type": {
"type": "string"
},
"billing_code": {
"type": "string"
},
"billing_code_type": {
"type": "string"
}
}
}Search HRSA 340B OPAIS covered entities + child sites by state, entity type (FQHC/DSH/CAH/RHC/…), or name — the 340B buyer/pharmacy roster. Answers: which 340B-eligible entities operate in my territory, and which have an NPI to join into the provider graph? Powers pharma-sales (340B pharmacies) targeting. Filter: state, entity_type, name, has_npi, parents_only. [price: $0.03/call]
| Argument | Type | Description |
|---|---|---|
| name | string | case-insensitive substring of the entity name |
| sort | string | name|active_since|state, optionally :asc/:desc |
| limit | integer | |
| state | string | 2-letter state code(s), comma-separated |
| offset | integer | |
| has_npi | boolean | only entities with a published NPI |
| entity_type | string | HRSA entity type code(s), comma-separated, e.g. 'FQHC,DSH,CAH' |
| parents_only | boolean | only parent covered entities (exclude child sites) |
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "case-insensitive substring of the entity name"
},
"sort": {
"type": "string",
"description": "name|active_since|state, optionally :asc/:desc"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string",
"description": "2-letter state code(s), comma-separated"
},
"offset": {
"type": "integer",
"default": 0
},
"has_npi": {
"type": "boolean",
"description": "only entities with a published NPI"
},
"entity_type": {
"type": "string",
"description": "HRSA entity type code(s), comma-separated, e.g. 'FQHC,DSH,CAH'"
},
"parents_only": {
"type": "boolean",
"description": "only parent covered entities (exclude child sites)"
}
}
}Discover FQHC / Look-Alike health-center SITES from the HRSA roster by state, type, county, name, or newly-added-to-scope date (added_since = new-site trigger). Answers: which FQHC sites exist in my territory, and which are new? Each site is entity-resolved into NPPES (matched_npi / match_method). Powers pharma-sales 340B, medical-device, and medical/travel-nurse staffing targeting. Filter: state, health_center_type, status, name, county, added_since, resolved_only. [price: $0.03/call]
| Argument | Type | Description |
|---|---|---|
| name | string | case-insensitive substring of the site name |
| sort | string | site_added_to_scope|site_name|site_state, optionally :asc/:desc |
| limit | integer | |
| state | string | 2-letter state code(s), comma-separated |
| county | string | county name substring |
| offset | integer | |
| status | string | site status, e.g. 'Active' |
| added_since | string | sites added to scope on/after this date (YYYY-MM-DD) — new-site trigger |
| resolved_only | boolean |
Find HRSA Health Professional Shortage Areas (Primary Care / Dental / Mental Health) by state, discipline, minimum shortage score, or FTE shortage — a mapped staffing-demand signal. Answers: where is the designated shortage most severe, and how many practitioner FTEs are needed? Powers medical & travel-nurse staffing. Defaults to currently-designated areas. Filter: state, discipline, min_score, min_fte, rural_status, designated_since, status; sort by hpsa_score or hpsa_fte. [price: $0.03/call]
| Argument | Type | Description |
|---|---|---|
| sort | string | hpsa_score|hpsa_fte|designation_date|designation_population, optionally :asc/:desc |
| limit | integer | |
| state | string | 2-letter state code(s), comma-separated |
| offset | integer | |
| status | string | override the default 'Designated' filter |
| min_fte | number | minimum practitioner FTE shortage |
| min_score | number | minimum HPSA score (0-26; higher = greater shortage) |
| discipline | string | 'Primary Care' | 'Dental Health' | 'Mental Health' (substring) |
| rural_status |
Search nonprofit hospital executive compensation: officers and key employees by organization (EIN), name, or compensation range. Answers: who are the executives at this nonprofit health org and what do they earn? Source: IRS Form 990 Schedule J. [price: $0.02/call]
| Argument | Type | Description |
|---|---|---|
| ein | string | |
| limit | integer | |
| offset | integer | |
| name_search | string | |
| total_compensation_max | number | |
| total_compensation_min | number |
{
"type": "object",
"properties": {
"ein": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"offset": {
"type": "integer",
"default": 0
},
"name_search": {
"type": "string"
},
"total_compensation_max": {
"type": "number"
},
"total_compensation_min": {
"type": "number"
}
}
}Nonprofit health organization Form 990 filing history by EIN. Answers: what are the revenues, expenses, and trends for this nonprofit across fiscal years? Source: IRS Form 990 e-filings. [price: $0.01/call]
| Argument | Type | Description |
|---|---|---|
| ein* | string | Path parameter: IRS Employer Identification Number (EIN) |
{
"type": "object",
"required": [
"ein"
],
"properties": {
"ein": {
"type": "string",
"description": "Path parameter: IRS Employer Identification Number (EIN)"
}
}
}Search nonprofit health organizations by state, NTEE code, revenue or expense range, or name. Answers: which nonprofit hospitals/health orgs match this financial profile? Source: IRS Form 990 e-filings. [price: $0.02/call]
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| state | string | |
| offset | integer | |
| ntee_code | string | |
| name_search | string | |
| revenue_max | number | |
| revenue_min | number | |
| net_income_max | number | |
| net_income_min | number |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string"
},
"offset": {
"type": "integer",
"default": 0
},
"ntee_code": {
"type": "string"
},
"name_search": {
"type": "string"
},
"revenue_max": {
"type": "number"
},
"revenue_min": {
"type": "number"
},
"net_income_max": {
"type": "number"
},
"net_income_min": {
"type": "number"
}
}
}Which manufacturers pay a given physician specialty in a territory, and how much — CMS Open Payments rolled up to the paying company. Answers: which pharma/device companies already reach cardiologists in Texas, and which are the small/emerging ones (max_total_spend) to partner with or compete against? Filter: specialty, state, performance_year (defaults to latest), max_total_spend/min_total_spend, min_physicians; sort by matched_amount or manufacturer_total_spend (asc = smallest first). [price: $0.03/call]
| Argument | Type | Description |
|---|---|---|
| sort | string | matched_amount|manufacturer_total_spend|first_seen_year|matched_physician_cells, optionally :asc/:desc |
| limit | integer | |
| state | string | 2-letter recipient state code(s), comma-separated |
| offset | integer | |
| specialty | string | Open Payments recipient specialty leaf, e.g. 'Cardiovascular Disease' |
| min_physicians | number | minimum matched physician×specialty×state relationships |
| max_total_spend | number | only manufacturers whose all-time reported spend is ≤ this (small/emerging) |
| min_total_spend | number |
Manufacturers/GPOs whose TOTAL Open Payments spend genuinely increased year-over-year — a real per-manufacturer delta (amount_current vs amount_prior), not a magnitude threshold. Defaults to 2023→2024 (any loaded year pair via year/prior_year). Filter: specialty, state, min_increase_usd (default $10,000), min_pct_change (default 10%). NOTE: op_manufacturer_payments holds only PY2024 today — real, returns total_matched=0 (never fabricated) until a prior year is imported; see stage1b-report.md. [price: $0.1/call]
| Argument | Type | Description |
|---|---|---|
| year | integer | current program year (default 2024, the latest loaded) |
| limit | integer | |
| state | string | 2-letter recipient state code(s), comma-separated |
| offset | integer | |
| specialty | string | recipient specialty substring, e.g. 'Cardiology' |
| prior_year | integer | comparison program year (default year-1) |
| min_pct_change | number | minimum percent increase (default 10) |
| min_increase_usd | number | minimum dollar increase (default 10000) |
Discover pharma & device MANUFACTURERS from CMS Open Payments by name, total-spend band, or year of first appearance — the emerging/small-brand filter (low total_spend and/or recent first_seen_year) plus optional specialty/state activity. Answers: which small or new manufacturers pay physicians in my category and territory? Entity-resolved company dimension (DBA/subsidiary variants merged). Filter: name, max_total_spend, first_seen_year_min/max, specialty, state. [price: $0.03/call]
| Argument | Type | Description |
|---|---|---|
| name | string | case-insensitive substring of the manufacturer name |
| sort | string | total_spend|first_seen_year|physician_engagements|distinct_specialties|display_name, optionally :asc/:desc |
| limit | integer | |
| state | string | 2-letter recipient state code(s), comma-separated |
| offset | integer | |
| specialty | string | Open Payments recipient specialty leaf, e.g. 'Cardiovascular Disease', 'Hematology & Oncology' |
| max_total_spend | number | only manufacturers whose all-time reported spend is ≤ this (small/emerging) |
| min_total_spend | number |
Newly-enumerated NPIs with their EXACT Provider Enumeration Date and taxonomy detail, from the CMS NPPES full monthly file joined to the NPPES directory. Answers: which providers/organizations of a given taxonomy were newly issued an NPI in my state since a date? Precise new-provider dating (enumerated_since) that sharpens the existing NPPES event feed. Filter: enumerated_since/before, taxonomy, state, license_state, entity_type, active_only; sort by enumeration_date. [price: $0.03/call]
| Argument | Type | Description |
|---|---|---|
| sort | string | enumeration_date|last_update_date, optionally :asc/:desc |
| limit | integer | |
| state | string | practice state (from NPPES directory), 2-letter code(s) |
| offset | integer | |
| taxonomy | string | primary Healthcare Provider Taxonomy code(s), comma-separated, e.g. '207Q00000X' |
| active_only | boolean | exclude deactivated NPIs |
| entity_type | string | 'I' individual | 'O' organization |
| license_state | string | primary license state code(s) |
| enumerated_since |
Healthcare wage benchmarks by SOC occupation and area (national, state, metro): median, mean, and P25–P90 percentiles plus employment. Answers: what does this role pay in this market? Source: BLS OEWS. [price: $0.02/call]
| Argument | Type | Description |
|---|---|---|
| year | integer | |
| limit | integer | |
| state | string | |
| offset | integer | |
| area_code | string | |
| area_type | string | |
| occupation_code | string |
{
"type": "object",
"properties": {
"year": {
"type": "integer"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string"
},
"offset": {
"type": "integer",
"default": 0
},
"area_code": {
"type": "string"
},
"area_type": {
"type": "string"
},
"occupation_code": {
"type": "string"
}
}
}Screen physicians industry is already paying — the recipient side of the CMS Open Payments (Sunshine Act) file, ranked by total reported payment amount. Filter by specialty, state, nature_of_payment, and min_amount. Prescriber name / specialty / state / city are resolved by joining the NPI to the CMS Part D Prescribers file (Open Payments carries none of them). Public CMS provider-level data; not a consumer report. [price: $0.1/call]
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| state | string | 2-letter prescriber state code(s), comma-separated |
| offset | integer | |
| specialty | string | prescriber specialty substring, e.g. 'Cardiology' |
| min_amount | number | minimum reported total payment amount (USD) |
| performance_year | integer | Open Payments program year (default 2024, the latest loaded) |
| nature_of_payment | string | payment category substring, e.g. 'Consulting' |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string",
"description": "2-letter prescriber state code(s), comma-separated"
},
"offset": {
"type": "integer",
"default": 0
},
"specialty": {
"type": "string",
"description": "prescriber specialty substring, e.g. 'Cardiology'"
},
"min_amount": {
"type": "number",
"description": "minimum reported total payment amount (USD)"
},
"performance_year": {
"type": "integer",
"description": "Open Payments program year (default 2024, the latest loaded)"
},
"nature_of_payment": {
"type": "string",
"description": "payment category substring, e.g. 'Consulting'"
}
}
}Physicians whose TOTAL CMS Open Payments industry payments genuinely increased year-over-year — a real per-NPI delta (amount_current vs amount_prior), not a magnitude threshold. Defaults to 2023→2024 (any loaded year pair selectable via year/prior_year). Filter: specialty, state, min_increase_usd (default $1,000), min_pct_change (default 10%). Only physicians paid in BOTH years with a real rise clearing both thresholds are returned. Public CMS provider-level data; not a consumer report. [price: $0.1/call]
| Argument | Type | Description |
|---|---|---|
| year | integer | current program year (default 2024, the latest loaded) |
| limit | integer | |
| state | string | 2-letter prescriber state code(s), comma-separated |
| offset | integer | |
| specialty | string | prescriber specialty substring, e.g. 'Cardiology' |
| prior_year | integer | comparison program year (default year-1) |
| min_pct_change | number | minimum percent increase (default 10) |
| min_increase_usd | number | minimum dollar increase (default 1000) |
Look up a prescriber by NAME (or exact NPI) and get identity plus a Medicare Part D prescribing summary. Matches the NPPES directory by name prefix (first/last), optionally narrowed by state and specialty, then rolls up that NPI's latest-year Part D claims: top drug, distinct drugs, beneficiaries, and tracked class flags (GLP-1/SGLT2/DPP-4/Statin) with a new-to-class signal. Provide name or npi. Public CMS + NPPES provider-level data; not a consumer report. [price: $0.05/call]
| Argument | Type | Description |
|---|---|---|
| npi | string | exact 10-digit NPI (alternative to name) |
| name | string | prescriber name, free-text; 'Smith' (last-name prefix) or 'John Smith' (first + last prefixes) |
| limit | integer | |
| state | string | 2-letter state code(s), comma-separated — narrows the name match |
| offset | integer | |
| specialty | string | NPPES specialty substring, e.g. 'Endocrinology' |
{
"type": "object",
"properties": {
"npi": {
"type": "string",
"description": "exact 10-digit NPI (alternative to name)"
},
"name": {
"type": "string",
"description": "prescriber name, free-text; 'Smith' (last-name prefix) or 'John Smith' (first + last prefixes)"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string",
"description": "2-letter state code(s), comma-separated — narrows the name match"
},
"offset": {
"type": "integer",
"default": 0
},
"specialty": {
"type": "string",
"description": "NPPES specialty substring, e.g. 'Endocrinology'"
}
}
}Find Medicare Part D prescribers of a therapeutic class whose specialty is OUTSIDE the class's typical set — off-specialty early adopters (e.g. a GLP-1 written by a cardiologist or nephrologist rather than an endocrinologist/PCP). Filter by drug_class (GLP-1|SGLT2|DPP-4|Statin), min_claims, state; override the typical set with typical_specialties. Public CMS provider-level data; not a consumer report. [price: $0.1/call]
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| state | string | 2-letter prescriber state code(s), comma-separated |
| offset | integer | |
| specialty | string | further restrict the atypical set to a specialty substring |
| drug_class* | string | therapeutic class from partd_drug_class: 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin' |
| min_claims | integer | minimum PY2024 class claims (default 20) |
| typical_specialties | string | override the built-in typical set (comma-separated substrings); atypical = the complement |
{
"type": "object",
"required": [
"drug_class"
],
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string",
"description": "2-letter prescriber state code(s), comma-separated"
},
"offset": {
"type": "integer",
"default": 0
},
"specialty": {
"type": "string",
"description": "further restrict the atypical set to a specialty substring"
},
"drug_class": {
"type": "string",
"description": "therapeutic class from partd_drug_class: 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin'"
},
"min_claims": {
"type": "integer",
"description": "minimum PY2024 class claims (default 20)"
},
"typical_specialties": {
"type": "string",
"description": "override the built-in typical set (comma-separated substrings); atypical = the complement"
}
}
}Find prescribers whose within-class molecule mix shifted toward or away from a molecule year-over-year (PY2023→PY2024) — e.g. GLP-1 prescribers moving share toward Tirzepatide. Params: drug_class (GLP-1|SGLT2|DPP-4|Statin), molecule (a generic in the class), direction (toward|away), min_claims (class volume), min_share_shift (percentage points), state, specialty. Share is molecule claims ÷ class claims that year. Public CMS data; not a consumer report. [price: $0.1/call]
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| state | string | 2-letter prescriber state code(s), comma-separated |
| offset | integer | |
| molecule* | string | a generic within the class, e.g. 'Tirzepatide' or 'Empagliflozin' |
| direction | string | share moved toward the molecule (default) or away from it |
| specialty | string | prescriber specialty substring |
| drug_class* | string | therapeutic class from partd_drug_class: 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin' |
| min_claims | integer | minimum PY2024 class claims (default 50) |
Find Medicare Part D prescribers of a specific DRUG or therapeutic CLASS at NPI level — the core pharma targeting query. Filter by drug_class (GLP-1, SGLT2, DPP-4, Statin, from partd_drug_class) or a single drug (brand or generic, e.g. 'Ozempic'), plus specialty, state, min_claims, min_beneficiaries, year. Each hit carries the drug's claim/cost volume and the prescriber's specialty/state/city. Public CMS provider-level data; not a consumer report. [price: $0.03/call]
| Argument | Type | Description |
|---|---|---|
| drug | string | a single drug, brand or generic (e.g. 'Ozempic' or 'Semaglutide'); brands resolve to the canonical generic |
| year | integer | performance year (loaded: 2023, 2024; default 2024) |
| limit | integer | |
| state | string | 2-letter prescriber state code(s), comma-separated |
| offset | integer | |
| specialty | string | prescriber specialty substring, e.g. 'Endocrinology' |
| brand_name | string | CMS brand-name prefix (case-insensitive), e.g. 'Eliquis' |
| drug_class | string | therapeutic class from partd_drug_class, e.g. 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin' |
Find high-volume Medicare Part D prescribers of a therapeutic class who have NO reported CMS Open Payments — the greenfield 'reachable before a competitor' audience for a smaller or newer brand. Filter by drug_class (GLP-1|SGLT2|DPP-4|Statin), min_claims, state, specialty, and optionally nature_of_payment (whitespace within that payment category). Anti-join of by-drug prescribers to Open Payments recipients. Public CMS data; not a consumer report. [price: $0.1/call]
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| state | string | 2-letter prescriber state code(s), comma-separated |
| offset | integer | |
| engaged | string | true → INVERT: high-volume class prescribers who ARE receiving Open Payments (reachable KOLs), with op_total_amount. Default false = whitespace (unpaid). |
| specialty | string | prescriber specialty substring, e.g. 'Endocrinology' |
| drug_class* | string | therapeutic class from partd_drug_class: 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin' |
| min_claims | integer | minimum PY2024 class claims to count as high-volume (default 50) |
| nature_of_payment |
Find prescribers who ENTERED or LEFT a Medicare Part D therapeutic class year-over-year (PY2023→PY2024) — the switchable moment for a pharma team. direction=new_entrant returns NPIs writing the class in 2024 who wrote ≤max_prior_claims in 2023 (new-to-class); direction=de_adopter returns NPIs whose class volume fell ≥min_pct_drop%. Filter by drug_class (GLP-1|SGLT2|DPP-4|Statin), state, specialty. Public CMS provider-level data; not a consumer report. [price: $0.1/call]
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| state | string | 2-letter prescriber state code(s), comma-separated |
| offset | integer | |
| direction | string | new_entrant (new-to-class, default) or de_adopter (churned out) |
| specialty | string | prescriber specialty substring, e.g. 'Endocrinology' |
| drug_class* | string | therapeutic class from partd_drug_class: 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin' |
| min_pct_drop | number | de_adopter: minimum % drop PY2023→PY2024 (default 50) |
| min_claims_2024 | integer | new_entrant: minimum PY2024 class claims (default 20) |
Screen Medicare Part D prescribers by specialty, state, and claim volume — the per-prescriber roster a pharma / device team targets. Optional drug_category (brand | opioid | opioid_long_acting | antibiotic) selects the matching CMS *_total_claims column for BOTH the min_claims threshold and the ranking (else total_claims). Returns one row per NPI with the CMS claim rollups. Public CMS provider-level data; not a consumer report. [price: $0.1/call]
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| state | string | 2-letter prescriber state code(s), comma-separated |
| offset | integer | |
| specialty | string | prescriber specialty substring, e.g. 'Endocrinology' |
| min_claims | integer | minimum claims on the selected column (default 50) |
| drug_category | string | select the matching CMS *_total_claims column (drives min_claims + sort); omit for total_claims |
| performance_year | integer | Part D program year (default 2024, the latest loaded) |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string",
"description": "2-letter prescriber state code(s), comma-separated"
},
"offset": {
"type": "integer",
"default": 0
},
"specialty": {
"type": "string",
"description": "prescriber specialty substring, e.g. 'Endocrinology'"
},
"min_claims": {
"type": "integer",
"description": "minimum claims on the selected column (default 50)"
},
"drug_category": {
"enum": [
"brand",
"opioid",
"opioid_long_acting",
"antibiotic"
],
"type": "string",
"description": "select the matching CMS *_total_claims column (drives min_claims + sort); omit for total_claims"
},
"performance_year": {
"type": "integer",
"description": "Part D program year (default 2024, the latest loaded)"
}
}
}Provider change-event feed over 7 federal sources: new NPI enumerations, newly billing Medicare, enrollment pending, address changes, deactivations, CLIA lab certificates, ownership changes (CHOW), mammography facility cert changes, and hospital capex jumps. Answers: what changed in my territory since I last looked? Filter by type (comma-separated), state, since (YYYY-MM-DD), npi, ccn; page via next_cursor (keyset). 85k+ events, refreshed twice-weekly to quarterly by source. [price: $0.1/call]
| Argument | Type | Description |
|---|---|---|
| ccn | string | |
| npi | string | |
| type | string | comma-separated event types: enrollment_pending, newly_billing, new_enumeration, address_change, deactivation, new_lab_certificate, lab_cert_upgrade, ownership_change, new_mammo_facility, mammo_decert, capex_jump |
| limit | integer | |
| since | string | only events on/after this date (YYYY-MM-DD) |
| state | string | 2-letter state code(s), comma-separated |
| cursor | string | opaque next_cursor from the previous page |
{
"type": "object",
"properties": {
"ccn": {
"type": "string"
},
"npi": {
"type": "string"
},
"type": {
"type": "string",
"description": "comma-separated event types: enrollment_pending, newly_billing, new_enumeration, address_change, deactivation, new_lab_certificate, lab_cert_upgrade, ownership_change, new_mammo_facility, mammo_decert, capex_jump"
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100
},
"since": {
"type": "string",
"format": "date",
"description": "only events on/after this date (YYYY-MM-DD)"
},
"state": {
"type": "string",
"description": "2-letter state code(s), comma-separated"
},
"cursor": {
"type": "string",
"description": "opaque next_cursor from the previous page"
}
}
}One-call dossier of everything Healthparse knows about a provider NPI: NPPES identity, taxonomy and practice address; Medicare ordering-and-referring privileges; NPI exclusion screen (OIG LEIE, GSA SAM, state Medicaid, state boards); change-event history; Medicare Part B utilization and Part D prescribing summaries; Open Payments totals by year; hospital affiliations with star ratings; MIPS quality scores. Absent legs say so explicitly. Records as filed; not a consumer report. [price: $0.25/call]
| Argument | Type | Description |
|---|---|---|
| npi* | string | Path parameter: 10-digit National Provider Identifier (NPI) |
{
"type": "object",
"required": [
"npi"
],
"properties": {
"npi": {
"type": "string",
"description": "Path parameter: 10-digit National Provider Identifier (NPI)"
}
}
}Search the OIG List of Excluded Individuals/Entities (LEIE) by name, NPI, state, or exclusion type. Answers: is this provider excluded from federal healthcare programs? Monthly refresh. [price: $0.03/call]
| Argument | Type | Description |
|---|---|---|
| npi | string | |
| limit | integer | |
| state | string | |
| offset | integer | |
| exclusion_type | string | |
| last_name_search | string | |
| business_name_search | string |
{
"type": "object",
"properties": {
"npi": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string"
},
"offset": {
"type": "integer",
"default": 0
},
"exclusion_type": {
"type": "string"
},
"last_name_search": {
"type": "string"
},
"business_name_search": {
"type": "string"
}
}
}Screen a provider (name and/or NPI) against all federal and state exclusion lists in one call — OIG LEIE, GSA SAM, OFAC SDN, FDA debarment, state Medicaid exclusions, and licensing-board sanctions from 13 states. Returns an attested clear/flagged verdict with per-list counts. NPI-only screens (no name) cover 4 of 6 lists — OFAC SDN and FDA debarment need a name; see lists_checked/lists_not_applicable. For hiring, credentialing, and vendor-onboarding agents. [price: $0.15/call]
| Argument | Type | Description |
|---|---|---|
| npi | string | |
| name | string |
{
"type": "object",
"properties": {
"npi": {
"type": "string"
},
"name": {
"type": "string"
}
}
}| total_revenues_max |
| number |
| total_revenues_min | number |
| operating_margin_max | number |
| operating_margin_min | number |
| total_discharges_max | number |
| total_discharges_min | number |
{
"type": "object",
"properties": {
"city": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string"
},
"offset": {
"type": "integer",
"default": 0
},
"zip_prefix": {
"type": "string"
},
"fy_end_year": {
"type": "integer"
},
"name_search": {
"type": "string"
},
"control_type": {
"type": "string"
},
"hospital_type": {
"type": "string"
},
"total_beds_max": {
"type": "number"
},
"total_beds_min": {
"type": "number"
},
"total_revenues_max": {
"type": "number"
},
"total_revenues_min": {
"type": "number"
},
"operating_margin_max": {
"type": "number"
},
"operating_margin_min": {
"type": "number"
},
"total_discharges_max": {
"type": "number"
},
"total_discharges_min": {
"type": "number"
}
}
}{
"type": "object",
"properties": {
"npi": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string"
},
"offset": {
"type": "integer",
"default": 0
},
"specialty": {
"type": "string"
},
"total_payment_max": {
"type": "number"
},
"total_payment_min": {
"type": "number"
},
"total_services_max": {
"type": "number"
},
"total_services_min": {
"type": "number"
},
"total_beneficiaries_max": {
"type": "number"
},
"total_beneficiaries_min": {
"type": "number"
}
}
}| only sites resolved into the NPPES graph (matched_npi present) |
| health_center_type | string | substring, e.g. 'FQHC' or 'Look-Alike' |
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "case-insensitive substring of the site name"
},
"sort": {
"type": "string",
"description": "site_added_to_scope|site_name|site_state, optionally :asc/:desc"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string",
"description": "2-letter state code(s), comma-separated"
},
"county": {
"type": "string",
"description": "county name substring"
},
"offset": {
"type": "integer",
"default": 0
},
"status": {
"type": "string",
"description": "site status, e.g. 'Active'"
},
"added_since": {
"type": "string",
"description": "sites added to scope on/after this date (YYYY-MM-DD) — new-site trigger"
},
"resolved_only": {
"type": "boolean",
"description": "only sites resolved into the NPPES graph (matched_npi present)"
},
"health_center_type": {
"type": "string",
"description": "substring, e.g. 'FQHC' or 'Look-Alike'"
}
}
}| string |
| e.g. 'Rural' | 'Non-Rural' |
| designated_since | string | designated on/after this date (YYYY-MM-DD) |
{
"type": "object",
"properties": {
"sort": {
"type": "string",
"description": "hpsa_score|hpsa_fte|designation_date|designation_population, optionally :asc/:desc"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string",
"description": "2-letter state code(s), comma-separated"
},
"offset": {
"type": "integer",
"default": 0
},
"status": {
"type": "string",
"description": "override the default 'Designated' filter"
},
"min_fte": {
"type": "number",
"description": "minimum practitioner FTE shortage"
},
"min_score": {
"type": "number",
"description": "minimum HPSA score (0-26; higher = greater shortage)"
},
"discipline": {
"type": "string",
"description": "'Primary Care' | 'Dental Health' | 'Mental Health' (substring)"
},
"rural_status": {
"type": "string",
"description": "e.g. 'Rural' | 'Non-Rural'"
},
"designated_since": {
"type": "string",
"description": "designated on/after this date (YYYY-MM-DD)"
}
}
}| performance_year | integer | program year; defaults to the latest loaded |
{
"type": "object",
"properties": {
"sort": {
"type": "string",
"description": "matched_amount|manufacturer_total_spend|first_seen_year|matched_physician_cells, optionally :asc/:desc"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string",
"description": "2-letter recipient state code(s), comma-separated"
},
"offset": {
"type": "integer",
"default": 0
},
"specialty": {
"type": "string",
"description": "Open Payments recipient specialty leaf, e.g. 'Cardiovascular Disease'"
},
"min_physicians": {
"type": "number",
"description": "minimum matched physician×specialty×state relationships"
},
"max_total_spend": {
"type": "number",
"description": "only manufacturers whose all-time reported spend is ≤ this (small/emerging)"
},
"min_total_spend": {
"type": "number"
},
"performance_year": {
"type": "integer",
"description": "program year; defaults to the latest loaded"
}
}
}{
"type": "object",
"properties": {
"year": {
"type": "integer",
"description": "current program year (default 2024, the latest loaded)"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string",
"description": "2-letter recipient state code(s), comma-separated"
},
"offset": {
"type": "integer",
"default": 0
},
"specialty": {
"type": "string",
"description": "recipient specialty substring, e.g. 'Cardiology'"
},
"prior_year": {
"type": "integer",
"description": "comparison program year (default year-1)"
},
"min_pct_change": {
"type": "number",
"description": "minimum percent increase (default 10)"
},
"min_increase_usd": {
"type": "number",
"description": "minimum dollar increase (default 10000)"
}
}
}| performance_year | integer |
| first_seen_year_max | integer |
| first_seen_year_min | integer | manufacturers first appearing in/after this program year |
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "case-insensitive substring of the manufacturer name"
},
"sort": {
"type": "string",
"description": "total_spend|first_seen_year|physician_engagements|distinct_specialties|display_name, optionally :asc/:desc"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string",
"description": "2-letter recipient state code(s), comma-separated"
},
"offset": {
"type": "integer",
"default": 0
},
"specialty": {
"type": "string",
"description": "Open Payments recipient specialty leaf, e.g. 'Cardiovascular Disease', 'Hematology & Oncology'"
},
"max_total_spend": {
"type": "number",
"description": "only manufacturers whose all-time reported spend is ≤ this (small/emerging)"
},
"min_total_spend": {
"type": "number"
},
"performance_year": {
"type": "integer"
},
"first_seen_year_max": {
"type": "integer"
},
"first_seen_year_min": {
"type": "integer",
"description": "manufacturers first appearing in/after this program year"
}
}
}| string |
| NPIs enumerated on/after this date (YYYY-MM-DD) |
| enumerated_before | string | NPIs enumerated on/before this date (YYYY-MM-DD) |
{
"type": "object",
"properties": {
"sort": {
"type": "string",
"description": "enumeration_date|last_update_date, optionally :asc/:desc"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string",
"description": "practice state (from NPPES directory), 2-letter code(s)"
},
"offset": {
"type": "integer",
"default": 0
},
"taxonomy": {
"type": "string",
"description": "primary Healthcare Provider Taxonomy code(s), comma-separated, e.g. '207Q00000X'"
},
"active_only": {
"type": "boolean",
"description": "exclude deactivated NPIs"
},
"entity_type": {
"type": "string",
"description": "'I' individual | 'O' organization"
},
"license_state": {
"type": "string",
"description": "primary license state code(s)"
},
"enumerated_since": {
"type": "string",
"description": "NPIs enumerated on/after this date (YYYY-MM-DD)"
},
"enumerated_before": {
"type": "string",
"description": "NPIs enumerated on/before this date (YYYY-MM-DD)"
}
}
}{
"type": "object",
"properties": {
"year": {
"type": "integer",
"description": "current program year (default 2024, the latest loaded)"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string",
"description": "2-letter prescriber state code(s), comma-separated"
},
"offset": {
"type": "integer",
"default": 0
},
"specialty": {
"type": "string",
"description": "prescriber specialty substring, e.g. 'Cardiology'"
},
"prior_year": {
"type": "integer",
"description": "comparison program year (default year-1)"
},
"min_pct_change": {
"type": "number",
"description": "minimum percent increase (default 10)"
},
"min_increase_usd": {
"type": "number",
"description": "minimum dollar increase (default 1000)"
}
}
}| min_share_shift | number | minimum absolute share change in percentage points (default 10) |
{
"type": "object",
"required": [
"drug_class",
"molecule"
],
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string",
"description": "2-letter prescriber state code(s), comma-separated"
},
"offset": {
"type": "integer",
"default": 0
},
"molecule": {
"type": "string",
"description": "a generic within the class, e.g. 'Tirzepatide' or 'Empagliflozin'"
},
"direction": {
"enum": [
"toward",
"away"
],
"type": "string",
"description": "share moved toward the molecule (default) or away from it"
},
"specialty": {
"type": "string",
"description": "prescriber specialty substring"
},
"drug_class": {
"type": "string",
"description": "therapeutic class from partd_drug_class: 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin'"
},
"min_claims": {
"type": "integer",
"description": "minimum PY2024 class claims (default 50)"
},
"min_share_shift": {
"type": "number",
"description": "minimum absolute share change in percentage points (default 10)"
}
}
}| min_claims | integer | minimum total Part D claims for the drug (that year) |
| generic_name | string | CMS generic-name prefix (case-insensitive), e.g. 'Apixaban' |
| min_beneficiaries | integer | minimum total beneficiaries (null/suppressed rows excluded) |
{
"type": "object",
"properties": {
"drug": {
"type": "string",
"description": "a single drug, brand or generic (e.g. 'Ozempic' or 'Semaglutide'); brands resolve to the canonical generic"
},
"year": {
"type": "integer",
"description": "performance year (loaded: 2023, 2024; default 2024)"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string",
"description": "2-letter prescriber state code(s), comma-separated"
},
"offset": {
"type": "integer",
"default": 0
},
"specialty": {
"type": "string",
"description": "prescriber specialty substring, e.g. 'Endocrinology'"
},
"brand_name": {
"type": "string",
"description": "CMS brand-name prefix (case-insensitive), e.g. 'Eliquis'"
},
"drug_class": {
"type": "string",
"description": "therapeutic class from partd_drug_class, e.g. 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin'"
},
"min_claims": {
"type": "integer",
"description": "minimum total Part D claims for the drug (that year)"
},
"generic_name": {
"type": "string",
"description": "CMS generic-name prefix (case-insensitive), e.g. 'Apixaban'"
},
"min_beneficiaries": {
"type": "integer",
"description": "minimum total beneficiaries (null/suppressed rows excluded)"
}
}
}| string |
| optional: whitespace within a payment category, e.g. 'Consulting'; omit for no payments at all |
{
"type": "object",
"required": [
"drug_class"
],
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string",
"description": "2-letter prescriber state code(s), comma-separated"
},
"offset": {
"type": "integer",
"default": 0
},
"engaged": {
"type": "string",
"description": "true → INVERT: high-volume class prescribers who ARE receiving Open Payments (reachable KOLs), with op_total_amount. Default false = whitespace (unpaid)."
},
"specialty": {
"type": "string",
"description": "prescriber specialty substring, e.g. 'Endocrinology'"
},
"drug_class": {
"type": "string",
"description": "therapeutic class from partd_drug_class: 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin'"
},
"min_claims": {
"type": "integer",
"description": "minimum PY2024 class claims to count as high-volume (default 50)"
},
"nature_of_payment": {
"type": "string",
"description": "optional: whitespace within a payment category, e.g. 'Consulting'; omit for no payments at all"
}
}
}| max_prior_claims | integer | new_entrant: maximum PY2023 class claims to still count as 'new' (default 0) |
| min_prior_claims | integer | de_adopter: minimum PY2023 class claims (the base they dropped from; default 20) |
{
"type": "object",
"required": [
"drug_class"
],
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 100
},
"state": {
"type": "string",
"description": "2-letter prescriber state code(s), comma-separated"
},
"offset": {
"type": "integer",
"default": 0
},
"direction": {
"enum": [
"new_entrant",
"de_adopter"
],
"type": "string",
"description": "new_entrant (new-to-class, default) or de_adopter (churned out)"
},
"specialty": {
"type": "string",
"description": "prescriber specialty substring, e.g. 'Endocrinology'"
},
"drug_class": {
"type": "string",
"description": "therapeutic class from partd_drug_class: 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin'"
},
"min_pct_drop": {
"type": "number",
"description": "de_adopter: minimum % drop PY2023→PY2024 (default 50)"
},
"min_claims_2024": {
"type": "integer",
"description": "new_entrant: minimum PY2024 class claims (default 20)"
},
"max_prior_claims": {
"type": "integer",
"description": "new_entrant: maximum PY2023 class claims to still count as 'new' (default 0)"
},
"min_prior_claims": {
"type": "integer",
"description": "de_adopter: minimum PY2023 class claims (the base they dropped from; default 20)"
}
}
}