{"uid":"cap_5AKtbSTnwx9ID7c0vhI-d","slug":"healthparse-medicare-provider-search-42d7f541","name":"HealthParse Medicare Provider Search","description":"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.","url":"https://api.healthparse.io/v1/providers/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","properties":{"npi":{"type":"string"},"limit":{"type":"integer","default":25,"maximum":100},"state":{"type":"string"},"offset":{"type":"integer","default":0},"specialty":{"type":"string"},"total_payment_max":{"type":"number"},"total_payment_min":{"type":"number"},"total_services_max":{"type":"number"},"total_services_min":{"type":"number"},"total_beneficiaries_max":{"type":"number"},"total_beneficiaries_min":{"type":"number"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ybxhStyWVKm8IcOuKsQfh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search and filter Medicare providers by NPI, state, specialty, service volume, beneficiary count, or payment amounts using CMS Medicare claims data.","exampleAgentPrompt":"Find me Medicare providers in Texas who specialize in cardiology, saw at least 500 beneficiaries, and received more than $200,000 in total payments — show me the top 25 results.","exampleUseCases":null,"resultDescription":"A paginated list of Medicare provider records matching the search criteria, including NPI, specialty, state, total services rendered, total beneficiaries served, and total Medicare payments received, sourced from CMS Medicare claims data.","failureModes":["Invalid NPI format returns empty results or validation error","State code not recognized returns no results","Specialty string does not match CMS taxonomy returns no results","Min value exceeds max value for range filters causes error or empty result","Offset beyond result set returns empty array","Rate limit or payment failure returns 402 or 429 error"],"whenToPreferThis":"Use this endpoint when you need to discover, filter, or analyze Medicare providers from CMS claims data across dimensions like specialty, geography, billing volume, beneficiary count, or payment amounts. Prefer this over general provider directories when Medicare-specific activity data (services, beneficiaries, payments) is required for market analysis, competitive intelligence, or provider identification.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:52:28.960Z","isFirstParty":false}