{"name":"Healthparse Agent Gateway","endpoints":[{"id":"hcris.hospital.search","path":"/v1/hospitals/search","method":"GET","summary":"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_usd":0.02,"price_atomic_usdc":"20000","dataset":"hcris","input_schema":{"type":"object","properties":{"state":{"type":"string"},"city":{"type":"string"},"name_search":{"type":"string"},"hospital_type":{"type":"string"},"control_type":{"type":"string"},"fy_end_year":{"type":"integer"},"zip_prefix":{"type":"string"},"total_beds_min":{"type":"number"},"total_beds_max":{"type":"number"},"total_discharges_min":{"type":"number"},"total_discharges_max":{"type":"number"},"total_revenues_min":{"type":"number"},"total_revenues_max":{"type":"number"},"operating_margin_min":{"type":"number"},"operating_margin_max":{"type":"number"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"rows":[{"ccn":"450054","name":"EXAMPLE HOSPITAL","state":"TX","total_beds":320}],"total_matched":1},"license_url":"https://api.healthparse.io/v1/license/hcris"},{"id":"hcris.hospital.byCcn","path":"/v1/hospitals/:ccn","method":"GET","summary":"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_usd":0.01,"price_atomic_usdc":"10000","dataset":"hcris","input_schema":{"type":"object","properties":{},"required":[]},"output_example":{"rows":[{"ccn":"450054","fy_end_year":2025,"total_revenues":1200000000}],"total_matched":10},"license_url":"https://api.healthparse.io/v1/license/hcris"},{"id":"hcris.asc.search","path":"/v1/asc/search","method":"GET","summary":"Search ambulatory surgical centers (ASCs) by state, CCN, or name. Answers: which ASCs are in a given market? Source: CMS ASC cost data.","price_usd":0.02,"price_atomic_usdc":"20000","dataset":"hcris","input_schema":{"type":"object","properties":{"state":{"type":"string"},"ccn":{"type":"string"},"name_search":{"type":"string"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"rows":[{"ccn":"67C001","state":"TX"}],"total_matched":1},"license_url":"https://api.healthparse.io/v1/license/hcris"},{"id":"hcris.provider.search","path":"/v1/providers/search","method":"GET","summary":"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_usd":0.02,"price_atomic_usdc":"20000","dataset":"hcris","input_schema":{"type":"object","properties":{"npi":{"type":"string"},"state":{"type":"string"},"specialty":{"type":"string"},"total_services_min":{"type":"number"},"total_services_max":{"type":"number"},"total_beneficiaries_min":{"type":"number"},"total_beneficiaries_max":{"type":"number"},"total_payment_min":{"type":"number"},"total_payment_max":{"type":"number"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"rows":[{"npi":"1234567890","specialty":"Internal Medicine","state":"TX"}],"total_matched":1},"license_url":"https://api.healthparse.io/v1/license/hcris"},{"id":"irs990.org.search","path":"/v1/nonprofits/search","method":"GET","summary":"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_usd":0.02,"price_atomic_usdc":"20000","dataset":"irs990","input_schema":{"type":"object","properties":{"state":{"type":"string"},"ntee_code":{"type":"string"},"name_search":{"type":"string"},"revenue_min":{"type":"number"},"revenue_max":{"type":"number"},"net_income_min":{"type":"number"},"net_income_max":{"type":"number"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"rows":[{"ein":"740000000","name":"EXAMPLE HEALTH SYSTEM","total_revenue":500000000}],"total_matched":1},"license_url":"https://api.healthparse.io/v1/license/irs990"},{"id":"irs990.org.byEin","path":"/v1/nonprofits/:ein","method":"GET","summary":"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_usd":0.01,"price_atomic_usdc":"10000","dataset":"irs990","input_schema":{"type":"object","properties":{},"required":[]},"output_example":{"rows":[{"ein":"740000000","fy":2024,"total_revenue":500000000}],"total_matched":8},"license_url":"https://api.healthparse.io/v1/license/irs990"},{"id":"irs990.officers.search","path":"/v1/nonprofits/officers/search","method":"GET","summary":"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_usd":0.02,"price_atomic_usdc":"20000","dataset":"irs990","input_schema":{"type":"object","properties":{"ein":{"type":"string"},"name_search":{"type":"string"},"total_compensation_min":{"type":"number"},"total_compensation_max":{"type":"number"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"rows":[{"ein":"740000000","officer":"EXAMPLE, CEO","compensation":1250000}],"total_matched":1},"license_url":"https://api.healthparse.io/v1/license/irs990"},{"id":"sanctions.leie.search","path":"/v1/exclusions/search","method":"GET","summary":"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_usd":0.03,"price_atomic_usdc":"30000","dataset":"sanctions","input_schema":{"type":"object","properties":{"last_name_search":{"type":"string"},"business_name_search":{"type":"string"},"npi":{"type":"string"},"state":{"type":"string"},"exclusion_type":{"type":"string"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"rows":[{"name":"EXAMPLE, PERSON","npi":null,"state":"FL","exclusion_type":"1128a1"}],"total_matched":1},"license_url":"https://api.healthparse.io/v1/license/sanctions"},{"id":"oews.wage.search","path":"/v1/wages/search","method":"GET","summary":"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_usd":0.02,"price_atomic_usdc":"20000","dataset":"bls_oews","input_schema":{"type":"object","properties":{"occupation_code":{"type":"string"},"area_type":{"type":"string"},"state":{"type":"string"},"area_code":{"type":"string"},"year":{"type":"integer"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"rows":[{"occupation_code":"29-1141","area":"Austin-Round Rock, TX","annual_median":85200}],"total_matched":1},"license_url":"https://api.healthparse.io/v1/license/bls_oews"},{"id":"carecompare.hospitals.search","path":"/v1/facilities/hospitals/search","method":"GET","summary":"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_usd":0.02,"price_atomic_usdc":"20000","dataset":"care_compare","input_schema":{"type":"object","properties":{"state":{"type":"string"},"city":{"type":"string"},"zip_prefix":{"type":"string"},"overall_rating_min":{"type":"number"},"overall_rating_max":{"type":"number"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"rows":[{"ccn":"450054","star_rating":4,"state":"TX"}],"total_matched":1},"license_url":"https://api.healthparse.io/v1/license/care_compare"},{"id":"carecompare.hospitals.byCcn","path":"/v1/facilities/hospitals/:ccn","method":"GET","summary":"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_usd":0.01,"price_atomic_usdc":"10000","dataset":"care_compare","input_schema":{"type":"object","properties":{},"required":[]},"output_example":{"rows":[{"ccn":"450054","star_rating":4}],"total_matched":1},"license_url":"https://api.healthparse.io/v1/license/care_compare"},{"id":"carecompare.snf.search","path":"/v1/facilities/snf/search","method":"GET","summary":"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_usd":0.02,"price_atomic_usdc":"20000","dataset":"care_compare","input_schema":{"type":"object","properties":{"state":{"type":"string"},"city":{"type":"string"},"zip_prefix":{"type":"string"},"overall_rating_min":{"type":"number"},"overall_rating_max":{"type":"number"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"rows":[{"ccn":"450054","star_rating":4,"state":"TX"}],"total_matched":1},"license_url":"https://api.healthparse.io/v1/license/care_compare"},{"id":"carecompare.snf.byCcn","path":"/v1/facilities/snf/:ccn","method":"GET","summary":"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_usd":0.01,"price_atomic_usdc":"10000","dataset":"care_compare","input_schema":{"type":"object","properties":{},"required":[]},"output_example":{"rows":[{"ccn":"450054","star_rating":4}],"total_matched":1},"license_url":"https://api.healthparse.io/v1/license/care_compare"},{"id":"carecompare.home-health.search","path":"/v1/facilities/home-health/search","method":"GET","summary":"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_usd":0.02,"price_atomic_usdc":"20000","dataset":"care_compare","input_schema":{"type":"object","properties":{"state":{"type":"string"},"city":{"type":"string"},"zip_prefix":{"type":"string"},"rating_min":{"type":"number"},"rating_max":{"type":"number"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"rows":[{"ccn":"450054","star_rating":4,"state":"TX"}],"total_matched":1},"license_url":"https://api.healthparse.io/v1/license/care_compare"},{"id":"carecompare.home-health.byCcn","path":"/v1/facilities/home-health/:ccn","method":"GET","summary":"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_usd":0.01,"price_atomic_usdc":"10000","dataset":"care_compare","input_schema":{"type":"object","properties":{},"required":[]},"output_example":{"rows":[{"ccn":"450054","star_rating":4}],"total_matched":1},"license_url":"https://api.healthparse.io/v1/license/care_compare"},{"id":"carecompare.hospice.search","path":"/v1/facilities/hospice/search","method":"GET","summary":"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_usd":0.02,"price_atomic_usdc":"20000","dataset":"care_compare","input_schema":{"type":"object","properties":{"state":{"type":"string"},"city":{"type":"string"},"zip_prefix":{"type":"string"},"rating_min":{"type":"number"},"rating_max":{"type":"number"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"rows":[{"ccn":"450054","star_rating":4,"state":"TX"}],"total_matched":1},"license_url":"https://api.healthparse.io/v1/license/care_compare"},{"id":"carecompare.hospice.byCcn","path":"/v1/facilities/hospice/:ccn","method":"GET","summary":"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_usd":0.01,"price_atomic_usdc":"10000","dataset":"care_compare","input_schema":{"type":"object","properties":{},"required":[]},"output_example":{"rows":[{"ccn":"450054","star_rating":4}],"total_matched":1},"license_url":"https://api.healthparse.io/v1/license/care_compare"},{"id":"carecompare.dialysis.search","path":"/v1/facilities/dialysis/search","method":"GET","summary":"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_usd":0.02,"price_atomic_usdc":"20000","dataset":"care_compare","input_schema":{"type":"object","properties":{"state":{"type":"string"},"city":{"type":"string"},"zip_prefix":{"type":"string"},"rating_min":{"type":"number"},"rating_max":{"type":"number"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"rows":[{"ccn":"450054","star_rating":4,"state":"TX"}],"total_matched":1},"license_url":"https://api.healthparse.io/v1/license/care_compare"},{"id":"carecompare.dialysis.byCcn","path":"/v1/facilities/dialysis/:ccn","method":"GET","summary":"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_usd":0.01,"price_atomic_usdc":"10000","dataset":"care_compare","input_schema":{"type":"object","properties":{},"required":[]},"output_example":{"rows":[{"ccn":"450054","star_rating":4}],"total_matched":1},"license_url":"https://api.healthparse.io/v1/license/care_compare"},{"id":"hpt.rates.search","path":"/v1/prices/search","method":"GET","summary":"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_usd":0.03,"price_atomic_usdc":"30000","dataset":"hpt","input_schema":{"type":"object","properties":{"billing_code":{"type":"string"},"billing_code_type":{"type":"string"},"state":{"type":"string"},"payer":{"type":"string"},"ccn":{"type":"string"},"rate_type":{"type":"string"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"rows":[{"ccn":"450054","billing_code":"70450","payer_name_canonical":"Aetna","negotiated_rate":412.5}],"total_matched":1},"license_url":"https://api.healthparse.io/v1/license/hpt"},{"id":"sanctions.screen","path":"/v1/screen","method":"GET","summary":"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_usd":0.15,"price_atomic_usdc":"150000","dataset":"sanctions","input_schema":{"type":"object","properties":{"name":{"type":"string"},"npi":{"type":"string"}}},"output_example":{"verdict":{"clear":true,"hits":0,"flagged_lists":[]},"per_list":{"oig_leie":0,"gsa_sam":0,"ofac_sdn":null,"fda_debarment":null,"state_medicaid":0,"state_boards":0},"lists_checked":["oig_leie","gsa_sam","state_medicaid","state_boards"],"lists_not_applicable":["ofac_sdn","fda_debarment"]},"license_url":"https://api.healthparse.io/v1/license/sanctions"},{"id":"hpt.code.stats","path":"/v1/prices/stats/:code","method":"GET","summary":"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_usd":0.005,"price_atomic_usdc":"5000","dataset":"hpt","input_schema":{"type":"object","properties":{}},"output_example":{"billing_code":"70450","billing_code_type":"CPT","neg_p25":101.96,"neg_median":207,"neg_p75":924,"n_hospitals":952},"license_url":"https://api.healthparse.io/v1/license/hpt"},{"id":"hcris.hospital.financials","path":"/v1/hospitals/:ccn/financials","method":"GET","summary":"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_usd":0.05,"price_atomic_usdc":"50000","dataset":"hcris","input_schema":{"type":"object","properties":{}},"output_example":{"ccn":"450054","years":[{"fy_end_year":2025,"total_revenues":1200000000}]},"license_url":"https://api.healthparse.io/v1/license/hcris"},{"id":"providers.events.feed","path":"/v1/providers/events","method":"GET","summary":"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_usd":0.1,"price_atomic_usdc":"100000","dataset":"provider_events","input_schema":{"type":"object","properties":{"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"},"state":{"type":"string","description":"2-letter state code(s), comma-separated"},"since":{"type":"string","format":"date","description":"only events on/after this date (YYYY-MM-DD)"},"npi":{"type":"string"},"ccn":{"type":"string"},"cursor":{"type":"string","description":"opaque next_cursor from the previous page"},"limit":{"type":"integer","maximum":100,"default":50}}},"output_example":{"total_matched":2,"events":[{"event_id":84210,"event_date":"2026-07-12","event_type":"new_enumeration","npi":"1999999999","ccn":null,"entity_name":"EXAMPLE CLINIC LLC","city":"AUSTIN","state":"TX","details":{"entity_type":"organization"},"source":"nppes_weekly_v2","source_vintage":"2026-07-12"}],"next_cursor":"djF8MjAyNi0wNy0xMnw4NDIxMA"},"license_url":"https://api.healthparse.io/v1/license/provider_events"},{"id":"hospitals.capex.signals","path":"/v1/hospitals/capex-signals","method":"GET","summary":"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_usd":0.1,"price_atomic_usdc":"100000","dataset":"provider_events","input_schema":{"type":"object","properties":{"state":{"type":"string","description":"2-letter state code(s), comma-separated"},"min_amount":{"type":"number","description":"minimum movable-equipment purchase dollars in the trigger year"},"since":{"type":"string","format":"date","description":"only events on/after this date (YYYY-MM-DD)"},"cursor":{"type":"string","description":"opaque next_cursor from the previous page"},"limit":{"type":"integer","maximum":100,"default":50}}},"output_example":{"total_matched":1,"signals":[{"event_id":85001,"event_date":"2025-12-31","ccn":"280077","hospital_name":"EXAMPLE HEALTH","city":"FREMONT","state":"NE","fy_end_year":2025,"movable_equipment_purchases":4286370,"prior_year_movable_equipment_purchases":120000,"total_purchases":5638633}],"next_cursor":null},"license_url":"https://api.healthparse.io/v1/license/provider_events"},{"id":"providers.provider360","path":"/v1/providers/:npi/provider360","method":"GET","summary":"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_usd":0.25,"price_atomic_usdc":"250000","dataset":"provider360","input_schema":{"type":"object","properties":{}},"output_example":{"npi":"1154300549","records_notice":"Observational summary of public records as filed with NPPES and CMS program files. Not a consumer report...","legs_available":["identity","medicare_order_referring","exclusions_screen","change_events","medicare_utilization","part_d_prescribing","open_payments","hospital_affiliations","quality_mips"],"legs_unavailable":[],"identity":{"available":true,"entity_type":"I","provider_name":"PRUTHI, RAJIV","taxonomy_code":"207RH0000X","practice_address":{"address":"200 1ST ST SW","city":"ROCHESTER","state":"MN","zip":"55905"},"deactivated":false},"medicare_order_referring":{"available":true,"can_order_refer":{"part_b":true,"dme":true,"hha":true,"pmd":true,"hospice":true}},"exclusions_screen":{"available":true,"verdict":{"clear":true,"hits":0,"flagged_lists":[]},"per_list":{"oig_leie":0,"gsa_sam":0,"ofac_sdn":null,"fda_debarment":null,"state_medicaid":0,"state_boards":0},"lists_not_applicable":["ofac_sdn","fda_debarment"]},"change_events":{"available":true,"total_events":0,"events":[]},"medicare_utilization":{"available":true,"performance_year":2022,"primary_specialty":"Hematology","total_services":55954,"total_payment":2049913.51},"part_d_prescribing":{"available":true,"years":[{"performance_year":2024,"total_claims":36,"total_drug_cost":161808.44,"opioid_total_claims":0}]},"open_payments":{"available":true,"years":[{"performance_year":2024,"total_amount":8371.84,"total_records":7,"by_nature":[{"nature_of_payment":"Travel and Lodging","total_amount":4791.81,"total_records":4}]}]},"hospital_affiliations":{"available":true,"facilities":[{"facility_type":"Hospital","ccn":"240010","facility_name":"MAYO CLINIC HOSPITAL ROCHESTER","city":"ROCHESTER","state":"MN","overall_rating":5}]},"quality_mips":{"available":true,"years":[{"performance_year":2022,"final_score":96.9,"payment_adjustment_pct":6.36}]}},"license_url":"https://api.healthparse.io/v1/license/provider360"},{"id":"manufacturers.search","path":"/v1/manufacturers/search","method":"GET","summary":"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_usd":0.03,"price_atomic_usdc":"30000","dataset":"open_payments_manufacturers","input_schema":{"type":"object","properties":{"name":{"type":"string","description":"case-insensitive substring of the manufacturer name"},"max_total_spend":{"type":"number","description":"only manufacturers whose all-time reported spend is ≤ this (small/emerging)"},"min_total_spend":{"type":"number"},"first_seen_year_min":{"type":"integer","description":"manufacturers first appearing in/after this program year"},"first_seen_year_max":{"type":"integer"},"specialty":{"type":"string","description":"Open Payments recipient specialty leaf, e.g. 'Cardiovascular Disease', 'Hematology & Oncology'"},"state":{"type":"string","description":"2-letter recipient state code(s), comma-separated"},"performance_year":{"type":"integer"},"sort":{"type":"string","description":"total_spend|first_seen_year|physician_engagements|distinct_specialties|display_name, optionally :asc/:desc"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"records_notice":"Observational rollup of the CMS Open Payments General Payments file, keyed on the paying manufacturer/GPO...","total_matched":1,"rows":[{"manufacturer_key":"MISSION PHARMACAL","display_name":"Mission Pharmacal Company","name_variants":["Mission Pharmacal Company"],"maker_ids":["100000000123"],"first_seen_year":2022,"last_seen_year":2025,"total_spend":842190.55,"payment_count":51233,"record_count":48120,"physician_engagements":9021,"distinct_specialties":44,"distinct_states":51,"top_specialty":"Urology","top_state":"TX"}]},"license_url":"https://api.healthparse.io/v1/license/open_payments_manufacturers"},{"id":"manufacturers.openPayments","path":"/v1/manufacturers/open-payments","method":"GET","summary":"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_usd":0.03,"price_atomic_usdc":"30000","dataset":"open_payments_manufacturers","input_schema":{"type":"object","properties":{"specialty":{"type":"string","description":"Open Payments recipient specialty leaf, e.g. 'Cardiovascular Disease'"},"state":{"type":"string","description":"2-letter recipient state code(s), comma-separated"},"performance_year":{"type":"integer","description":"program year; defaults to the latest loaded"},"max_total_spend":{"type":"number","description":"only manufacturers whose all-time reported spend is ≤ this (small/emerging)"},"min_total_spend":{"type":"number"},"min_physicians":{"type":"number","description":"minimum matched physician×specialty×state relationships"},"sort":{"type":"string","description":"matched_amount|manufacturer_total_spend|first_seen_year|matched_physician_cells, optionally :asc/:desc"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"records_notice":"Observational rollup of the CMS Open Payments General Payments file, keyed on the paying manufacturer/GPO...","performance_year":2025,"total_matched":2,"rows":[{"manufacturer_key":"C:Johnson & Johnson (Janssen)","display_name":"Johnson & Johnson (Janssen)","first_seen_year":2022,"last_seen_year":2025,"manufacturer_total_spend":214880332.1,"matched_amount":1820441.22,"matched_payments":41233,"matched_physician_cells":5120,"matched_states":51}]},"license_url":"https://api.healthparse.io/v1/license/open_payments_manufacturers"},{"id":"hrsa.healthCenters.search","path":"/v1/health-centers/search","method":"GET","summary":"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_usd":0.03,"price_atomic_usdc":"30000","dataset":"hrsa","input_schema":{"type":"object","properties":{"state":{"type":"string","description":"2-letter state code(s), comma-separated"},"health_center_type":{"type":"string","description":"substring, e.g. 'FQHC' or 'Look-Alike'"},"status":{"type":"string","description":"site status, e.g. 'Active'"},"name":{"type":"string","description":"case-insensitive substring of the site name"},"county":{"type":"string","description":"county name substring"},"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)"},"sort":{"type":"string","description":"site_added_to_scope|site_name|site_state, optionally :asc/:desc"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"records_notice":"Observational roster of FQHC / FQHC Look-Alike service-delivery sites as published by the HRSA Data Warehouse. matched_npi is this site resolved into the NPPES provider graph (match_method: 'site_npi' = HRSA-published FQHC Site NPI present in NPPES; 'address' = normalized practice-address match).","total_matched":1,"rows":[{"bphc_assigned_number":"BPS-H80-000078","health_center_type":"Federally Qualified Health Center (FQHC)","site_name":"Duval Family Health Center","site_address":"611 E Adams St","site_city":"Jacksonville","site_state":"FL","site_status":"Active","fqhc_site_npi":"1234567890","site_added_to_scope":"2001-11-01","matched_npi":"1234567890","match_method":"site_npi"}]},"license_url":"https://api.healthparse.io/v1/license/hrsa"},{"id":"hrsa.hpsa.search","path":"/v1/hpsa/search","method":"GET","summary":"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_usd":0.03,"price_atomic_usdc":"30000","dataset":"hrsa","input_schema":{"type":"object","properties":{"state":{"type":"string","description":"2-letter state code(s), comma-separated"},"discipline":{"type":"string","description":"'Primary Care' | 'Dental Health' | 'Mental Health' (substring)"},"min_score":{"type":"number","description":"minimum HPSA score (0-26; higher = greater shortage)"},"min_fte":{"type":"number","description":"minimum practitioner FTE shortage"},"rural_status":{"type":"string","description":"e.g. 'Rural' | 'Non-Rural'"},"designated_since":{"type":"string","description":"designated on/after this date (YYYY-MM-DD)"},"status":{"type":"string","description":"override the default 'Designated' filter"},"sort":{"type":"string","description":"hpsa_score|hpsa_fte|designation_date|designation_population, optionally :asc/:desc"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"records_notice":"Observational roster of HRSA Health Professional Shortage Area designations. One row per HPSA component (facility/geography) per discipline; a higher hpsa_score (0-26) and larger hpsa_fte shortage indicate greater designated shortage — a staffing-demand signal, not a judgment about any provider.","total_matched":1,"rows":[{"hpsa_id":"1123456789","hpsa_name":"Low Income - Duval County","discipline_class":"Primary Care","hpsa_score":18,"status":"Designated","hpsa_fte":12.5,"primary_state":"FL","county_name":"Duval","designation_date":"2018-06-01"}]},"license_url":"https://api.healthparse.io/v1/license/hrsa"},{"id":"hrsa.coveredEntities340b.search","path":"/v1/covered-entities-340b/search","method":"GET","summary":"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_usd":0.03,"price_atomic_usdc":"30000","dataset":"hrsa","input_schema":{"type":"object","properties":{"state":{"type":"string","description":"2-letter state code(s), comma-separated"},"entity_type":{"type":"string","description":"HRSA entity type code(s), comma-separated, e.g. 'FQHC,DSH,CAH'"},"name":{"type":"string","description":"case-insensitive substring of the entity name"},"has_npi":{"type":"boolean","description":"only entities with a published NPI"},"parents_only":{"type":"boolean","description":"only parent covered entities (exclude child sites)"},"sort":{"type":"string","description":"name|active_since|state, optionally :asc/:desc"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"records_notice":"Observational roster of HRSA 340B OPAIS covered entities and child sites. Presence means the entity is listed as 340B-eligible in the public OPAIS file; npi (when present) resolves it into the NPPES graph.","total_matched":1,"rows":[{"oei_number":"123456","parent_oei":null,"entity_type":"FQHC","name":"Community Health Center Inc","city":"Hartford","state":"CT","npi":"1234567890"}]},"license_url":"https://api.healthparse.io/v1/license/hrsa"},{"id":"nppes.enumeration.search","path":"/v1/providers/enumeration","method":"GET","summary":"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_usd":0.03,"price_atomic_usdc":"30000","dataset":"nppes_directory","input_schema":{"type":"object","properties":{"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)"},"taxonomy":{"type":"string","description":"primary Healthcare Provider Taxonomy code(s), comma-separated, e.g. '207Q00000X'"},"state":{"type":"string","description":"practice state (from NPPES directory), 2-letter code(s)"},"license_state":{"type":"string","description":"primary license state code(s)"},"entity_type":{"type":"string","description":"'I' individual | 'O' organization"},"active_only":{"type":"boolean","description":"exclude deactivated NPIs"},"sort":{"type":"string","description":"enumeration_date|last_update_date, optionally :asc/:desc"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"records_notice":"Enrichment of the NPPES provider directory with exact Provider Enumeration Dates and taxonomy detail from the CMS full monthly file. Rows join nppes_org_links for provider/org name + practice state. enumeration_date is the official NPI issue date (precise new-provider dating).","total_matched":1,"rows":[{"npi":"1234567890","entity_type":"I","enumeration_date":"2025-01-05","primary_taxonomy_code":"207Q00000X","primary_taxonomy_switch":"Y","license_state":"FL","taxonomy_codes":["207Q00000X"],"provider_name":"SMITH, JANE","practice_state":"FL"}]},"license_url":"https://api.healthparse.io/v1/license/nppes_directory"},{"id":"prescribers.partDByDrug.search","path":"/v1/prescribers/part-d/by-drug/search","method":"GET","summary":"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_usd":0.03,"price_atomic_usdc":"30000","dataset":"cms_part_d","input_schema":{"type":"object","properties":{"drug_class":{"type":"string","description":"therapeutic class from partd_drug_class, e.g. 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin'"},"drug":{"type":"string","description":"a single drug, brand or generic (e.g. 'Ozempic' or 'Semaglutide'); brands resolve to the canonical generic"},"brand_name":{"type":"string","description":"CMS brand-name prefix (case-insensitive), e.g. 'Eliquis'"},"generic_name":{"type":"string","description":"CMS generic-name prefix (case-insensitive), e.g. 'Apixaban'"},"specialty":{"type":"string","description":"prescriber specialty substring, e.g. 'Endocrinology'"},"state":{"type":"string","description":"2-letter prescriber state code(s), comma-separated"},"min_claims":{"type":"integer","description":"minimum total Part D claims for the drug (that year)"},"min_beneficiaries":{"type":"integer","description":"minimum total beneficiaries (null/suppressed rows excluded)"},"year":{"type":"integer","description":"performance year (loaded: 2023, 2024; default 2024)"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"records_notice":"Observational roster of Medicare Part D prescribers for the requested drug or therapeutic class, as published in the CMS 'by Provider and Drug' public file. One row per (NPI × drug) for the performance year; total_beneficiaries is null where CMS suppressed a count below 11. prescriber_specialty/state/city are the values filed on the CMS record. Provider-level program data — not a consumer report, and not for FCRA-regulated eligibility decisions.","performance_year":2024,"selectors":["drug_class=GLP-1"],"total_matched":1,"rows":[{"npi":"1234567890","performance_year":2024,"brand_name":"Ozempic","generic_name":"Semaglutide","total_claims":512,"total_30day_fills":618.4,"total_drug_cost":512340.11,"total_beneficiaries":88,"prescriber_specialty":"Endocrinology","prescriber_state":"TX","prescriber_city":"Houston"}]},"license_url":"https://api.healthparse.io/v1/license/cms_part_d"},{"id":"prescribers.partDClassYoyDelta.search","path":"/v1/prescribers/part-d/class-yoy-delta/search","method":"GET","summary":"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_usd":0.1,"price_atomic_usdc":"100000","dataset":"cms_part_d","input_schema":{"type":"object","properties":{"drug_class":{"type":"string","description":"therapeutic class from partd_drug_class: 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin'"},"direction":{"type":"string","enum":["new_entrant","de_adopter"],"description":"new_entrant (new-to-class, default) or de_adopter (churned out)"},"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)"},"min_pct_drop":{"type":"number","description":"de_adopter: minimum % drop PY2023→PY2024 (default 50)"},"specialty":{"type":"string","description":"prescriber specialty substring, e.g. 'Endocrinology'"},"state":{"type":"string","description":"2-letter prescriber state code(s), comma-separated"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}},"required":["drug_class"]},"output_example":{"drug_class":"GLP-1","direction":"new_entrant","year_pair":{"prior":2023,"current":2024},"total_matched":1,"rows":[{"npi":"1811284078","prescriber_specialty":"Endocrinology","prescriber_state":"TX","prescriber_city":"Edinburg","class_claims_2024":2110,"class_claims_2023":0,"class_claims_delta":2110,"pct_change":null}]},"license_url":"https://api.healthparse.io/v1/license/cms_part_d"},{"id":"prescribers.partDClassWhitespace.search","path":"/v1/prescribers/part-d/class-whitespace/search","method":"GET","summary":"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_usd":0.1,"price_atomic_usdc":"100000","dataset":"cms_part_d","input_schema":{"type":"object","properties":{"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"},"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'"},"state":{"type":"string","description":"2-letter prescriber state code(s), comma-separated"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}},"required":["drug_class"]},"output_example":{"drug_class":"GLP-1","performance_year":2024,"total_matched":1,"rows":[{"npi":"1053821504","prescriber_specialty":"Nurse Practitioner","prescriber_state":"TX","prescriber_city":"Waco","class_claims":1367}]},"license_url":"https://api.healthparse.io/v1/license/cms_part_d"},{"id":"prescribers.partDAtypicalSpecialty.search","path":"/v1/prescribers/part-d/atypical-specialty/search","method":"GET","summary":"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_usd":0.1,"price_atomic_usdc":"100000","dataset":"cms_part_d","input_schema":{"type":"object","properties":{"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"},"specialty":{"type":"string","description":"further restrict the atypical set to a specialty substring"},"state":{"type":"string","description":"2-letter prescriber state code(s), comma-separated"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}},"required":["drug_class"]},"output_example":{"drug_class":"GLP-1","performance_year":2024,"typical_specialties_excluded":["%Endocrin%","%Family%","%Internal Med%","%Nurse Prac%","%Physician Assist%","%General Prac%"],"total_matched":1,"rows":[{"npi":"1811962723","prescriber_specialty":"Nephrology","prescriber_state":"TX","prescriber_city":"Houston","class_claims":872}]},"license_url":"https://api.healthparse.io/v1/license/cms_part_d"},{"id":"prescribers.partDBrandShareShift.search","path":"/v1/prescribers/part-d/brand-share-shift/search","method":"GET","summary":"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_usd":0.1,"price_atomic_usdc":"100000","dataset":"cms_part_d","input_schema":{"type":"object","properties":{"drug_class":{"type":"string","description":"therapeutic class from partd_drug_class: 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin'"},"molecule":{"type":"string","description":"a generic within the class, e.g. 'Tirzepatide' or 'Empagliflozin'"},"direction":{"type":"string","enum":["toward","away"],"description":"share moved toward the molecule (default) or away from it"},"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)"},"specialty":{"type":"string","description":"prescriber specialty substring"},"state":{"type":"string","description":"2-letter prescriber state code(s), comma-separated"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}},"required":["drug_class","molecule"]},"output_example":{"drug_class":"GLP-1","molecule":"Tirzepatide","direction":"toward","year_pair":{"prior":2023,"current":2024},"total_matched":1,"rows":[{"npi":"1417243247","prescriber_specialty":"Family Practice","prescriber_state":"TX","prescriber_city":"Houston","class_claims_2024":85,"class_claims_2023":40,"molecule_share_2024":82.4,"molecule_share_2023":0,"share_shift_pts":82.4}]},"license_url":"https://api.healthparse.io/v1/license/cms_part_d"},{"id":"prescribers.lookup.search","path":"/v1/prescribers/lookup/search","method":"GET","summary":"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_usd":0.05,"price_atomic_usdc":"50000","dataset":"cms_part_d","input_schema":{"type":"object","properties":{"name":{"type":"string","description":"prescriber name, free-text; 'Smith' (last-name prefix) or 'John Smith' (first + last prefixes)"},"npi":{"type":"string","description":"exact 10-digit NPI (alternative to name)"},"state":{"type":"string","description":"2-letter state code(s), comma-separated — narrows the name match"},"specialty":{"type":"string","description":"NPPES specialty substring, e.g. 'Endocrinology'"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"records_notice":"Prescriber identity from the public NPPES provider directory joined to that NPI's Medicare Part D prescribing as published in the CMS 'by Provider and Drug' public file. Part D figures are for the latest loaded year (PY2024); 'beneficiaries' is the largest per-drug beneficiary count CMS publishes for the prescriber and is typically null in the current load (the by-drug file suppresses beneficiary counts below 11). Absence of Part D rows means no Medicare Part D activity was published for that NPI — not that the provider does not prescribe. Provider-level program data — not a consumer report, and not for FCRA-regulated eligibility decisions.","latest_year":2024,"field_visibility":{"teaser":["npi","prescriber_name","specialty","state","city","top_drug","total_drug_classes_tracked"],"gated":["has_part_d","total_part_d_claims","distinct_drugs","beneficiaries","top_drug_claims","writes_glp1","writes_sglt2","writes_dpp4","writes_statin","drug_classes_written","new_to_class","latest_year"]},"selectors":["name=smith"],"total_matched":1,"rows":[{"npi":"1952964959","prescriber_name":"Aarentino Smith","specialty":"Nurse Practitioner","state":"CA","city":"San Pablo","top_drug":"Atorvastatin Calcium","total_drug_classes_tracked":2,"has_part_d":true,"total_part_d_claims":1447,"distinct_drugs":28,"beneficiaries":null,"top_drug_claims":398,"writes_glp1":true,"writes_sglt2":false,"writes_dpp4":false,"writes_statin":true,"drug_classes_written":["GLP-1","Statin"],"new_to_class":false,"latest_year":2024}]},"license_url":"https://api.healthparse.io/v1/license/cms_part_d"},{"id":"prescribers.partD.search","path":"/v1/prescribers/part-d/search","method":"GET","summary":"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_usd":0.1,"price_atomic_usdc":"100000","dataset":"cms_part_d","input_schema":{"type":"object","properties":{"performance_year":{"type":"integer","description":"Part D program year (default 2024, the latest loaded)"},"state":{"type":"string","description":"2-letter prescriber state code(s), comma-separated"},"specialty":{"type":"string","description":"prescriber specialty substring, e.g. 'Endocrinology'"},"drug_category":{"type":"string","enum":["brand","opioid","opioid_long_acting","antibiotic"],"description":"select the matching CMS *_total_claims column (drives min_claims + sort); omit for total_claims"},"min_claims":{"type":"integer","description":"minimum claims on the selected column (default 50)"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"records_notice":"Observational, roster-level rollup of the CMS 'Medicare Part D Prescribers — by Provider' public file. One row per prescriber (NPI). Claim counts are the CMS totals for the stated year; the selected drug_category maps to the matching CMS *_total_claims column (brand / opioid / long-acting opioid / antibiotic), else total_claims. prescriber_specialty/state/city are the values filed on the CMS record. Provider-level program data — not a consumer report, and not for FCRA-regulated eligibility decisions.","performance_year":2024,"drug_category":null,"selectors":["performance_year=2024","state=TX","specialty=Endocrinology","min_claims=50"],"total_matched":1,"total_matched_capped":false,"rows":[{"npi":"1811284078","prescriber_name":"Doe, Jane","prescriber_specialty":"Endocrinology","prescriber_state":"TX","prescriber_city":"Edinburg","total_claims":2110,"brand_total_claims":640,"opioid_total_claims":0,"antibiotic_total_claims":12}]},"license_url":"https://api.healthparse.io/v1/license/cms_part_d"},{"id":"openPayments.recipients.search","path":"/v1/open-payments/recipients/search","method":"GET","summary":"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_usd":0.1,"price_atomic_usdc":"100000","dataset":"cms_open_payments","input_schema":{"type":"object","properties":{"performance_year":{"type":"integer","description":"Open Payments program year (default 2024, the latest loaded)"},"state":{"type":"string","description":"2-letter prescriber state code(s), comma-separated"},"specialty":{"type":"string","description":"prescriber specialty substring, e.g. 'Cardiology'"},"nature_of_payment":{"type":"string","description":"payment category substring, e.g. 'Consulting'"},"min_amount":{"type":"number","description":"minimum reported total payment amount (USD)"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"records_notice":"Observational rollup of the CMS Open Payments (Sunshine Act) General Payments file, keyed on the recipient NPI. A row means a physician appears in the public federal payments file for the stated year — not a judgment about the provider. Name / specialty / state / city are resolved by joining the NPI to the CMS Part D Prescribers file (the Open Payments file carries none of them). Provider-level program data — not a consumer report, and not for FCRA-regulated eligibility decisions.","performance_year":2024,"selectors":["performance_year=2024","state=CA","specialty=Cardiology","min_amount=1000"],"total_matched":1,"total_matched_capped":false,"rows":[{"npi":"1952964959","prescriber_name":"Roe, John","prescriber_specialty":"Cardiology","prescriber_state":"CA","prescriber_city":"San Pablo","nature_of_payment":"Consulting Fee","total_amount":42500,"total_records":18}]},"license_url":"https://api.healthparse.io/v1/license/cms_open_payments"},{"id":"openPayments.recipients.yoyIncrease.search","path":"/v1/open-payments/recipients/yoy-increase/search","method":"GET","summary":"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_usd":0.1,"price_atomic_usdc":"100000","dataset":"cms_open_payments","input_schema":{"type":"object","properties":{"year":{"type":"integer","description":"current program year (default 2024, the latest loaded)"},"prior_year":{"type":"integer","description":"comparison program year (default year-1)"},"state":{"type":"string","description":"2-letter prescriber state code(s), comma-separated"},"specialty":{"type":"string","description":"prescriber specialty substring, e.g. 'Cardiology'"},"min_increase_usd":{"type":"number","description":"minimum dollar increase (default 1000)"},"min_pct_change":{"type":"number","description":"minimum percent increase (default 10)"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"records_notice":"Observational year-over-year rollup of the CMS Open Payments (Sunshine Act) General Payments file, keyed on the recipient NPI. amount_current/amount_prior are the physician's TOTAL reported industry payments (all nature_of_payment categories summed) in the current vs prior program year; delta and pct_change are computed from those two real totals — not a single-period magnitude threshold. Only physicians who received a reported payment in BOTH years, with a real increase, are returned. A rise in reported payments is not a judgment about the physician or their prescribing — provider-level program data, not a consumer report, and not for FCRA-regulated eligibility decisions.","year":2024,"prior_year":2023,"selectors":["year=2024","prior_year=2023","min_increase_usd=1000","min_pct_change=10","state=TX","specialty=Cardiology"],"total_matched":873,"total_matched_capped":false,"rows":[{"npi":"1134115397","prescriber_name":"Doe, Jane","prescriber_specialty":"Cardiology","prescriber_state":"TX","prescriber_city":"Houston","amount_current":203423.89,"amount_prior":862.08,"delta":202561.81,"pct_change":23496.9}]},"license_url":"https://api.healthparse.io/v1/license/cms_open_payments"},{"id":"manufacturers.openPayments.yoyIncrease.search","path":"/v1/manufacturers/yoy-increase/search","method":"GET","summary":"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_usd":0.1,"price_atomic_usdc":"100000","dataset":"open_payments_manufacturers","input_schema":{"type":"object","properties":{"year":{"type":"integer","description":"current program year (default 2024, the latest loaded)"},"prior_year":{"type":"integer","description":"comparison program year (default year-1)"},"state":{"type":"string","description":"2-letter recipient state code(s), comma-separated"},"specialty":{"type":"string","description":"recipient specialty substring, e.g. 'Cardiology'"},"min_increase_usd":{"type":"number","description":"minimum dollar increase (default 10000)"},"min_pct_change":{"type":"number","description":"minimum percent increase (default 10)"},"limit":{"type":"integer","maximum":100,"default":25},"offset":{"type":"integer","default":0}}},"output_example":{"records_notice":"Observational year-over-year rollup of the CMS Open Payments (Sunshine Act) General Payments file, keyed on the paying manufacturer/GPO (op_manufacturer_payments, entity-resolved). amount_current/amount_prior are the company's TOTAL reported payments in the current vs prior program year; delta and pct_change are computed from those two real totals. Only manufacturers reporting payments in BOTH years, with a real increase, are returned. Not a judgment about the company or its products.","year":2024,"prior_year":2023,"selectors":["year=2024","prior_year=2023","min_increase_usd=10000","min_pct_change=10"],"total_matched":0,"total_matched_capped":false,"rows":[]},"license_url":"https://api.healthparse.io/v1/license/open_payments_manufacturers"}]}