{"uid":"cap_O93PzI3KxqdZ9rwakLXPx","slug":"providersignal-medicaid-rates-api-0b6748f2","name":"ProviderSignal Medicaid Rates API","description":"Healthcare market intelligence API. Unified provider directory + acquisition signals + license-events feed across all 50 US states, derived from NPI + state dental boards + CMS Medicare + OIG LEIE + state Medicaid + HRSA HPSA designations. All responses ship a citation envelope (`meta.envelope_version`, `meta.source_attribution`, `meta.request`) so agents can verify source freshness without out-of-band validation. Paid `/api/v1/agent/*` endpoints accept two per-call rails on a single 402: x402 (USDC on Base mainnet) and MPP (Stripe card via a Shared Payment Token), plus Bearer-token subscription auth for existing API keys. See [/docs/agent-payments](/docs/agent-payments) for the full flow. See [/docs/fields](/docs/fields) for the field glossary and [/llms.txt](/llms.txt) for the LLM crawler index.","url":"https://providersignal.com/api/v1/agent/medicaid/rates","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":["state"],"properties":{"code":{"type":"string","pattern":"^D\\d{4}$","description":"Optional CDT D-code (e.g. D2391) for a specific-procedure raw lookup."},"state":{"type":"string","pattern":"^[A-Z]{2}$","description":"Required. 2-letter state code (e.g. TX, FL, CA). All 50 states + DC covered."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","error","meta"],"properties":{"data":{"type":"object","properties":{"state":{"type":"string"},"basket":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","pattern":"^D\\d{4}$"},"rate":{"type":["number","null"]},"pediatric":{"type":"boolean"},"procedure":{"type":"string"}},"additionalProperties":true}},"disclaimer":{"type":"string"},"state_name":{"type":"string"},"total_codes":{"type":"integer"},"basket_index":{"type":["number","null"]},"total_ranked":{"type":"integer"},"national_rank":{"type":["integer","null"]},"effective_year":{"type":["integer","null"]}},"additionalProperties":true},"meta":{"type":"object","required":["envelope_version"],"properties":{"request":{"type":"object","properties":{"id":{"type":"string"},"endpoint":{"type":"string"},"billed_credits":{"type":"integer"},"billing_method":{"enum":["subscription","per_query","free","admin"],"type":"string"}}},"envelope_version":{"type":"string"},"source_attribution":{"type":"array","items":{"type":"object","properties":{"table":{"type":"string"},"license":{"type":"string"},"last_refresh":{"type":["string","null"]},"schema_version":{"type":"string"}}},"description":"Per-source citation: logical table, last successful refresh, schema version, license posture."}},"additionalProperties":true},"error":{"type":["object","null"],"description":"Null on success; { code, message } on failure."}}}}}}},"responseSchema":{"type":"json","example":{"data":{"state":"TX","basket":[{"code":"D0120","rate":24,"pediatric":false,"procedure":"Periodic oral exam"},{"code":"D2391","rate":88,"pediatric":false,"procedure":"1-surface composite filling"}],"disclaimer":"Published Medicaid fee-for-service schedule amounts, not a coverage or eligibility guarantee.","state_name":"Texas","total_codes":357,"basket_index":84,"total_ranked":51,"national_rank":18,"effective_year":2026},"meta":{"request":{"endpoint":"/api/v1/agent/medicaid/rates","billing_method":"per_query"},"envelope_version":"1.0"},"error":null}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-ZRgEwx-HWJA61Ir47hLa","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns published Medicaid fee-for-service reimbursement rates for dental procedures by US state, including basket index and national ranking.","exampleAgentPrompt":"What does Medicaid pay for a D2391 composite filling in Texas, and how does Texas rank nationally for Medicaid dental reimbursement rates?","exampleUseCases":[{"title":"Dental practice market entry analysis","prompt":"We're considering opening a dental practice that accepts Medicaid in Florida — can you pull the current Medicaid reimbursement rates and basket index for FL so I can see how it ranks nationally?"},{"title":"Procedure-specific rate lookup for billing","prompt":"What is the current Medicaid published rate for procedure code D0120 (periodic oral exam) in California for 2026?"},{"title":"State-by-state Medicaid rate benchmarking","prompt":"I need to compare how New York and Georgia rank nationally on Medicaid dental reimbursement — can you get the basket index and national rank for both states?"}],"resultDescription":"Returns a JSON object with the state's Medicaid fee-for-service dental rates including: an array of procedure codes with rates and descriptions, a basket index score, national ranking among all 50 states plus DC, total number of codes covered, effective year, and a disclaimer. Also includes a meta citation envelope with source attribution and request billing details.","failureModes":["Missing required 'state' query parameter returns a validation error","Invalid state code (not a 2-letter uppercase code) returns a pattern mismatch error","Invalid CDT code format (not matching ^D\\d{4}$) returns a validation error","State with no published Medicaid fee schedule may return null rates or empty basket","Payment failure via x402 or MPP returns HTTP 402 with payment instructions","Rate limiting or quota exhaustion returns a 429 or billing error"],"whenToPreferThis":"Use this endpoint when you need authoritative, source-cited Medicaid dental reimbursement rates for a specific US state, especially when you need CDT-code-level granularity, national ranking context, or a basket index for benchmarking. Prefer this over general healthcare data APIs when the use case is specifically dental Medicaid fee schedules with verifiable source attribution and freshness metadata.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T12:30:13.310Z","isFirstParty":false}