{"uid":"cap_EZSbs-NfF4j4MQFBqd-cw","slug":"medicare-part-d-prescriber-search-by-specialty-state-claim-volume-e78b5645","name":"Medicare Part D Prescriber Search by Specialty, State & Claim Volume","description":"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.","url":"https://api.healthparse.io/v1/prescribers/part-d/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","properties":{"limit":{"type":"integer","default":25,"maximum":100},"state":{"type":"string","description":"2-letter prescriber state code(s), comma-separated"},"offset":{"type":"integer","default":0},"specialty":{"type":"string","description":"prescriber specialty substring, e.g. 'Endocrinology'"},"min_claims":{"type":"integer","description":"minimum claims on the selected column (default 50)"},"drug_category":{"enum":["brand","opioid","opioid_long_acting","antibiotic"],"type":"string","description":"select the matching CMS *_total_claims column (drives min_claims + sort); omit for total_claims"},"performance_year":{"type":"integer","description":"Part D program year (default 2024, the latest loaded)"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1xFlCaQSSSnJsMVME-7eI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search and rank Medicare Part D prescribers by specialty, state, and claim volume using CMS provider-level data, with optional drug category filtering.","exampleAgentPrompt":"Give me the top 50 Medicare Part D endocrinologists in Texas and Florida ranked by brand drug claim volume, with a minimum of 100 brand claims, for performance year 2024.","exampleUseCases":[{"title":"Pharma field rep territory targeting","prompt":"Pull me up to 100 high-volume Medicare Part D cardiologists in New York and New Jersey with at least 75 total claims in 2024 — I need to build a target list for our field reps."},{"title":"Opioid prescriber compliance screening","prompt":"Find the top 50 Medicare Part D prescribers with the highest long-acting opioid claim volumes in Ohio and Kentucky for 2024, with a minimum of 50 opioid long-acting claims."},{"title":"Antibiotic stewardship market analysis","prompt":"I need a list of primary care prescribers in California who have high antibiotic prescription volumes under Medicare Part D in 2024 — show me up to 100 sorted by antibiotic claim volume with at least 100 antibiotic claims."}],"resultDescription":"Returns a paginated list of prescriber rows (up to 100 per call), each containing the prescriber's NPI, identity fields, specialty, state, and CMS claim rollup columns including total claims and the selected drug-category claim count used for filtering and ranking.","failureModes":["Invalid or unsupported state code returns empty results or validation error","Specialty substring with no matches returns empty result set","Performance year outside loaded range returns error or empty data","min_claims set too high returns no results","drug_category enum value misspelled causes validation error","Exceeding limit maximum of 100 returns validation error"],"whenToPreferThis":"Use this endpoint when you need to build a filtered, ranked roster of prescribers by specialty and geography based on Medicare Part D claim volume — particularly for pharma commercial targeting, compliance screening, or market sizing. Prefer this over the drug-specific search endpoint when you want to target prescribers by specialty/state rather than by a specific drug name. Prefer over the individual NPI lookup when you need a bulk list rather than a single provider's profile.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:51:55.751Z","isFirstParty":false}