{"uid":"cap_4t7kCb_1XOcLy0sHtJz4P","slug":"healthparse-national-price-stats-by-billing-code-f72db16a","name":"HealthParse National Price Stats by Billing Code","description":"National price statistics for a billing code (CPT/HCPCS/MS-DRG) from hospital price-transparency files: median and spread of payer-negotiated rates. Answers: what is a fair price for this procedure? Shape varies: a code under one billing_code_type (common case) returns the flat row shown below; a code ambiguous across types instead returns { billing_code, stats_by_type: [...] } — check for a top-level stats_by_type array to tell them apart.","url":"https://api.healthparse.io/v1/prices/stats/:code","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","properties":{}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oDPTsxE5NQEBj6j1XQf5p","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns national median and spread of payer-negotiated rates for a given billing code (CPT/HCPCS/MS-DRG) derived from hospital price-transparency files","exampleAgentPrompt":"What's a fair negotiated rate for CPT code 99213 based on national hospital price transparency data — give me the median and spread across payers.","exampleUseCases":null,"resultDescription":"A JSON object containing the billing code, its type (CPT/HCPCS/MS-DRG), and national statistics including median payer-negotiated rate and rate spread. If the code is unambiguous under one billing_code_type, returns a flat row; if the code maps across multiple types, returns a top-level stats_by_type array with per-type statistics.","failureModes":["Unknown or invalid billing code returns 404 or empty result","Code ambiguous across billing types returns stats_by_type array instead of flat row — agent must check for this field","No price data available for rare or new codes","Malformed code format may return 400 bad request","Rate data may be stale if hospital price transparency files have not been recently updated"],"whenToPreferThis":"Use this endpoint when you need national benchmark pricing for a specific medical procedure or service identified by a standard billing code (CPT, HCPCS, or MS-DRG). Ideal for cost transparency, healthcare price comparison, insurance negotiation research, or patient cost estimation. Prefer this over individual hospital price lookups when you want an aggregated national view of what payers actually negotiate.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:32:38.849Z","isFirstParty":false}