{"uid":"cap_ZEJJ1ITRFgdqGVnaAl3Tj","slug":"providersignal-medicaid-fee-schedule-api-0ccec4b2","name":"ProviderSignal Medicaid Fee Schedule 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/fee-schedule","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","properties":{"code":{"type":"string","pattern":"^[A-Z0-9-]{3,7}$","description":"Optional CPT / HCPCS / state-local procedure code (e.g. 99213, E0601). CDT dental codes belong to /medicaid/rates."},"state":{"type":"string","pattern":"^[A-Z]{2}$","description":"2-letter state code. Optional when `code` is given (omit for a cross-state comparison)."},"category":{"enum":["physician","lab_imaging","dme","drugs","vision","behavioral","anesthesia","hearing","ambulance","hcbs","other"],"type":"string","description":"Optional service category for state-level schedule stats. Requires `state`."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","error","meta"],"properties":{"data":{"type":"object","properties":{"code":{"type":"string"},"mode":{"enum":["state_categories","state_category_stats","code_compare","code_detail"],"type":"string"},"label":{"type":["string","null"]},"state":{"type":"string"},"stats":{"type":"object","properties":{"total":{"type":"integer"},"n_pa_required":{"type":"integer"},"max_effective_year":{"type":["integer","null"]},"median_pct_of_medicare":{"type":["number","null"]}},"additionalProperties":true},"detail":{"type":["object","null"],"additionalProperties":true},"states":{"type":"array","items":{"type":"object","properties":{"state":{"type":"string"},"is_bare":{"type":"boolean"},"pa_status":{"type":["string","null"]},"is_derived":{"type":"boolean"},"benchmark_rate":{"type":["number","null"]},"effective_year":{"type":["integer","null"]},"pct_of_medicare":{"type":["number","null"]}},"additionalProperties":true}},"categories":{"type":"array","items":{"type":"object","properties":{"codes":{"type":"integer"},"category":{"type":"string"}},"additionalProperties":true}},"disclaimer":{"type":"string"}},"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":{"code":"99213","mode":"code_compare","label":"Office visit, established patient, low complexity (20-29 min)","states":[{"state":"CA","is_bare":true,"pa_status":null,"benchmark_rate":82.02,"effective_year":2026,"pct_of_medicare":86.2},{"state":"TX","is_bare":false,"pa_status":null,"benchmark_rate":33.95,"effective_year":2026,"pct_of_medicare":35.7}],"disclaimer":"Published Medicaid fee-for-service schedule amounts, not a coverage or eligibility guarantee. Absence of a PA flag means the state does not publish one."},"meta":{"request":{"endpoint":"/api/v1/agent/medicaid/fee-schedule","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_6KF-99joYl6oTayMCgFHs","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 US Medicaid fee-for-service reimbursement rates for procedure codes across all 50 states, with cross-state comparisons and category-level statistics","exampleAgentPrompt":"What does Medicaid pay for CPT code 99213 across all states — I want to see the benchmark rates and what percentage of Medicare each state pays, especially California and Texas.","exampleUseCases":[{"title":"Cross-state reimbursement benchmarking for a procedure","prompt":"Can you pull the Medicaid fee schedule for CPT code 99213 across all states and show me the benchmark rates and what percentage of Medicare each one pays?"},{"title":"State category stats for contract negotiation","prompt":"I need Medicaid fee schedule stats for physician services in Texas — how many codes are covered, how many require prior auth, and what's the median rate relative to Medicare?"},{"title":"Prior auth burden analysis for a specific code","prompt":"Which states require prior authorization for HCPCS code E0601, and what are the Medicaid benchmark rates where it's covered?"}],"resultDescription":"Returns structured data with mode-specific fields: for code lookups, a per-state list with benchmark_rate, pct_of_medicare, effective_year, pa_status, and is_bare flags; for state+category queries, aggregate stats including total codes, count requiring prior auth, and median pct_of_medicare. All responses include a citation envelope with source attribution and envelope version for auditability.","failureModes":["Invalid CPT/HCPCS code format (must match ^[A-Z0-9-]{3,7}$) returns validation error","Invalid 2-letter state code returns error","Requesting category stats without providing a state returns error","Code not found in any state Medicaid schedule returns empty states array","402 Payment Required if no valid x402 USDC payment or MPP token or Bearer subscription key is provided","Rate data may be missing (null benchmark_rate) for states that publish bare schedules without dollar amounts"],"whenToPreferThis":"Use this endpoint when you need authoritative, cross-state Medicaid fee-for-service reimbursement data with source citations — particularly for benchmarking a specific CPT/HCPCS code against Medicare, auditing prior authorization requirements by state, or analyzing category-level fee schedule statistics. Prefer this over manual state lookups when you need structured, machine-readable data with freshness metadata across all 50 states in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T12:40:07.656Z","isFirstParty":false}