{"uid":"cap_EvaTsTzK6ubGhZB0tV6Kp","slug":"clearcarepulse-episode-of-care-total-cost-e96a33ca","name":"ClearCarePulse Episode-of-Care Total Cost","description":"Total episode-of-care cost for healthcare and patient-advocate agents. Sums every component, surgeon, facility, anesthesia, PT, and follow-up, into the real all-in price of a procedure.","url":"https://clear-care-pulse.vercel.app/api/care/episode","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["procedure"],"properties":{"lang":{"type":"string","description":"lang"},"oop_max":{"type":"string","description":"Annual out-of-pocket maximum in USD"},"procedure":{"type":"string","description":"procedure"},"deductible":{"type":"string","description":"Annual deductible in USD"},"coinsurance":{"type":"string","description":"Patient coinsurance % (default: 20)"},"deductible_met":{"type":"string","description":"Deductible already met this year in USD"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","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.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BFLKxdw73ipg7vi96qbTj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the all-in total cost of a medical procedure by summing every component — surgeon, facility, anesthesia, physical therapy, and follow-up visits — into a single episode-of-care price.","exampleAgentPrompt":"What's the real all-in cost for a total knee replacement procedure near zip code 78701 — I want every component broken out: surgeon, facility, anesthesia, physical therapy, and follow-up visits summed into one total?","exampleUseCases":[{"title":"Patient shopping for hip surgery","prompt":"I'm comparing hip replacement surgery costs at three different hospitals in my area. Can you get me the complete episode-of-care price for each one — including the surgeon, facility, anesthesia, physical therapy, and all follow-up visits — so I can see the real total I'd be paying out of pocket?"},{"title":"Insurance advocate gap analysis","prompt":"My patient's insurance is only covering part of their rotator cuff repair. Can you break down the full all-in cost of the procedure for me — surgeon fees, facility charges, anesthesia, PT, everything — so I can see exactly what gap my patient needs to cover?"},{"title":"Employee benefits counselor","prompt":"An employee asked me about the total cost of a back surgery procedure to help them decide if they should use their health savings account. Pull together the complete episode-of-care price including surgeon, facility, anesthesia, physical therapy, and follow-up visits so they can budget properly."}],"resultDescription":"Returns a structured breakdown of every cost component in the episode of care — surgeon fees, facility charges, anesthesia, physical therapy, and follow-up visits — plus a single summed all-in total price for the procedure.","failureModes":["Unknown or unsupported procedure code returns 404 or empty result","Zip code not covered by dataset returns limited or no pricing data","Missing required procedure identifier returns 400 bad request","Upstream pricing data unavailable returns 503 service error","Payment not processed (x402 not fulfilled) results in 402 Payment Required"],"whenToPreferThis":"Use this endpoint when a patient or advocate needs the true total cost of a procedure across all care components, not just the surgeon's fee or the facility charge alone. Prefer this over single-component lookup endpoints when the goal is financial planning, comparison shopping, or negotiating a bundled price. Ideal when downstream tasks include cost comparison, insurance gap analysis, or out-of-pocket budgeting.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:49:26.323Z","isFirstParty":false}