# ProviderSignal Medicaid Fee Schedule API > ProviderSignal Medicaid Fee Schedule API is a paid API for AI agents from providersignal.com, paid per call via x402, $0.5/call, status unknown (last checked 2026-09-16). Returns US Medicaid fee-for-service reimbursement rates for procedure codes across all 50 states, with cross-state comparisons and category-level statistics ## Facts - Endpoint: GET https://providersignal.com/api/v1/agent/medicaid/fee-schedule - Price: $0.5/call - Payment: x402 - Status: unknown - Last checked: 2026-09-16 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/providersignal-medicaid-fee-schedule-api-0ccec4b2 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZEJJ1ITRFgdqGVnaAl3Tj Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability providersignal-medicaid-fee-schedule-api-0ccec4b2 ``` Example prompt: 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. ## When to prefer this 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. ## Known failure modes - 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 ## How this service works 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. ## Output 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. ## Request schema (JSON Schema) ```json { "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" ] } … (truncated) ``` ## Response schema (JSON Schema) ```json { "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 } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/providersignal-medicaid-fee-schedule-api-0ccec4b2/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from providersignal.com](https://www.zero.xyz/host/providersignal.com/llms.txt)