Healthparse Healthcare Data Gateway

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]

{
  "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
    }
  }
}

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]

{
  "type": "object",
  "properties": {
    "ccn": {
      "type": "string",
      "description": "Path parameter: CMS Certification Number"
    }
  },
  "required": [
    "ccn"
  ]
}

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]

{
  "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
    }
  }
}

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]

{
  "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
    }
  }
}

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]

{
  "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
    }
  }
}

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]

{
  "type": "object",
  "properties": {
    "ein": {
      "type": "string",
      "description": "Path parameter: IRS Employer Identification Number (EIN)"
    }
  },
  "required": [
    "ein"
  ]
}

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]

{
  "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
    }
  }
}

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]

{
  "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
    }
  }
}

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]

{
  "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
    }
  }
}

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]

{
  "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
    }
  }
}

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]

{
  "type": "object",
  "properties": {
    "ccn": {
      "type": "string",
      "description": "Path parameter: CMS Certification Number"
    }
  },
  "required": [
    "ccn"
  ]
}

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]

{
  "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
    }
  }
}

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]

{
  "type": "object",
  "properties": {
    "ccn": {
      "type": "string",
      "description": "Path parameter: CMS Certification Number"
    }
  },
  "required": [
    "ccn"
  ]
}

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]

{
  "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
    }
  }
}

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]

{
  "type": "object",
  "properties": {
    "ccn": {
      "type": "string",
      "description": "Path parameter: CMS Certification Number"
    }
  },
  "required": [
    "ccn"
  ]
}

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]

{
  "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
    }
  }
}

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]

{
  "type": "object",
  "properties": {
    "ccn": {
      "type": "string",
      "description": "Path parameter: CMS Certification Number"
    }
  },
  "required": [
    "ccn"
  ]
}

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]

{
  "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
    }
  }
}

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]

{
  "type": "object",
  "properties": {
    "ccn": {
      "type": "string",
      "description": "Path parameter: CMS Certification Number"
    }
  },
  "required": [
    "ccn"
  ]
}

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]

{
  "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
    }
  }
}

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]

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "npi": {
      "type": "string"
    }
  }
}

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]

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Path parameter: billing code (CPT/HCPCS/MS-DRG)"
    }
  },
  "required": [
    "code"
  ]
}

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]

{
  "type": "object",
  "properties": {
    "ccn": {
      "type": "string",
      "description": "Path parameter: CMS Certification Number"
    }
  },
  "required": [
    "ccn"
  ]
}

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]

{
  "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
    }
  }
}

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]

{
  "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
    }
  }
}

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]

{
  "type": "object",
  "properties": {
    "npi": {
      "type": "string",
      "description": "Path parameter: 10-digit National Provider Identifier (NPI)"
    }
  },
  "required": [
    "npi"
  ]
}

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]

{
  "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
    }
  }
}

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]

{
  "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
    }
  }
}

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]

{
  "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
    }
  }
}

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]

{
  "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
    }
  }
}

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]

{
  "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
    }
  }
}

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]

{
  "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
    }
  }
}

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]

{
  "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
    }
  }
}

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]

{
  "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"
  ]
}

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]

{
  "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"
  ]
}

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]

{
  "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"
  ]
}

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]

{
  "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"
  ]
}

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]

{
  "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
    }
  }
}

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]

{
  "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
    }
  }
}

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]

{
  "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
    }
  }
}

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]

{
  "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
    }
  }
}

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]

{
  "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
    }
  }
}