{"uid":"cap_QmXaJziC13qtt4E-Qmt3F","slug":"cms-medicare-physician-compare-lookup-c721d6c1","name":"CMS Medicare Physician Compare Lookup","description":"CMS Medicare Doctors and Clinicians file: clinician NPI, name, credential, specialty, medical school, graduation year and practice location, by last name and optional state. Hospital affiliations are not in this file (only the practice group name). Up to 20 records per call.","url":"https://api.healthtravel-api.workers.dev/api/health/physician-compare-cms?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["last_name"],"properties":{"max":{"type":"string","description":"How many records, 1 to 20 (default 5)"},"state":{"type":"string","description":"Two-letter state code, optional"},"last_name":{"type":"string","description":"Clinician last name, letters, spaces, apostrophes and hyphens, 2 to 60 characters"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8w5qUdZF2eITRMvE1dB4V","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches the CMS Medicare Physicians and Clinicians dataset by last name (and optional state) to return clinician NPI, credentials, specialty, medical school, graduation year, and practice location.","exampleAgentPrompt":"Can you look up Dr. Smith in Texas from the CMS physician database and show me up to 10 results — I need their NPI, specialty, and where they practice?","exampleUseCases":[{"title":"Verify physician credentials before referral","prompt":"I need to verify a physician named Patel in California — can you pull their credentials, specialty, and medical school from the CMS clinician database? Show me up to 5 results."},{"title":"Find a specialist's NPI number","prompt":"What is the NPI number for Dr. Johnson who specializes in cardiology? Search the CMS Medicare physician records by last name Johnson in New York, up to 10 results."},{"title":"Research where a doctor trained","prompt":"Can you find out what medical school Dr. Rodriguez attended and what year they graduated? Look them up in the CMS physician compare file, last name Rodriguez, state Florida, give me up to 5 records."}],"resultDescription":"Returns up to 20 clinician records (default 5) per call, each containing: NPI number, full name, credential (e.g. MD, DO), specialty, medical school attended, graduation year, and practice location/group name. Hospital affiliations are not included.","failureModes":["last_name not provided — required parameter missing returns error","last_name too short (under 2 chars) or too long (over 60 chars) returns validation error","No matching clinicians found for given name/state combination — empty result set","Invalid state code returns no results or error","Result count outside 1-20 range is rejected or clamped","CMS source data temporarily unavailable — upstream data fetch failure"],"whenToPreferThis":"Use this endpoint when you need to look up US Medicare-participating clinicians by last name, retrieve their NPI, credentials, specialty, or training background from the official CMS Physician Compare dataset. Prefer this over general web searches when you need structured, authoritative CMS data for provider verification, NPI lookup, or credential checking. Not suitable for hospital affiliation lookup or non-Medicare providers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:44:38.157Z","isFirstParty":false,"canonicalSlug":"cms-medicare-physician-compare-lookup-c721d6c1"}