{"uid":"cap_IiPRzQnsAh_5lWOmwgs9f","slug":"findmydirectdoctor-colonoscopy-price-estimate-api-224afeb8","name":"FindMyDirectDoctor Colonoscopy Price Estimate API","description":"Colonoscopy price estimate near a location: posted hospital cash prices for four colonoscopy codes (diagnostic, with biopsy, with polyp removal, screening) with area medians, plus the Medicare 2026 allowed amounts at an ambulatory surgery center (surgery center) versus a hospital outpatient department for that ZIP, split into facility, doctor, anesthesia and lab. Plain explanations included. Reference prices, not quotes.","url":"https://api.findmydirectdoctor.com/v1/colonoscopy/estimate?utm_source=zero.xyz","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":[],"properties":{"lat":{"type":"number","maximum":90,"minimum":-90,"description":"Latitude in decimal degrees. Used together with lng."},"lng":{"type":"number","maximum":180,"minimum":-180,"description":"Longitude in decimal degrees. Used together with lat."},"zip":{"type":"string","pattern":"^\\d{5}$","description":"5-digit US ZIP code. A location is given as zip, or lat with lng, or city with state."},"city":{"type":"string","maxLength":80,"description":"City name. Used together with state."},"sort":{"enum":["price","distance"],"type":"string","default":"price","description":"How the hospitals under each code are ordered."},"limit":{"type":"integer","default":3,"maximum":10,"minimum":1,"description":"Results per page (default 3, maximum 10)."},"state":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"2-letter US state code. Used together with city."},"radius_miles":{"type":"number","default":50,"maximum":150,"description":"Search radius in miles (default 50, maximum 150). A larger value is lowered to the maximum.","exclusiveMinimum":0}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","hospital_cash_prices","medicare_2026_benchmark","explanations","data_as_of","disclaimer"],"properties":{"query":{"type":"object","description":"The request as understood."},"source":{"type":"string"},"flag_note":{"type":"string"},"data_as_of":{"type":"string"},"disclaimer":{"type":"string","description":"Posted hospital self-pay prices for the facility portion only. Final bills can differ. Confirm with the hospital."},"explanations":{"type":"array","items":{"type":"string"}},"hospital_cash_prices":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"meaning":{"type":"string"},"category":{"type":"string"},"hospitals":{"type":"array","items":{"type":"object","properties":{"ccn":{"type":"string","description":"CMS certification number."},"city":{"type":"string"},"flag":{"type":"string","description":"Data flag. Empty when none. See flag_key."},"name":{"type":"string"},"state":{"type":"string"},"fap_url":{"type":["string","null"],"description":"Verified financial assistance (charity care) page, or null."},"file_date":{"type":["string","null"],"description":"Date of the hospital's price file."},"cash_price_usd":{"type":"number","description":"Posted self-pay (cash) price, facility portion only."},"distance_miles":{"type":["number","null"]}}}},"plain_name":{"type":"string"},"area_prices":{"type":"object","properties":{"n_used":{"type":"integer"},"low_usd":{"type":["number","null"]},"p25_usd":{"type":["number","null"]},"p75_usd":{"type":["number","null"]},"high_usd":{"type":["number","null"]},"median_usd":{"type":["number","null"]}}},"national_median_usd":{"type":["number","null"]},"hospitals_with_price":{"type":"integer"}}}},"medicare_2026_benchmark":{"type":["object","null"],"properties":{"zip":{"type":"string"},"year":{"type":"integer"},"basis":{"type":"string"},"codes":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"note":{"type":"string"},"meaning":{"type":"string"},"plain_name":{"type":"string"},"surgery_center":{"type":"object","properties":{"total_usd":{"type":"number"},"doctor_usd":{"type":"number"},"facility_usd":{"type":"number"},"anesthesia_usd":{"type":"number"},"lab_exam_of_tissue_usd":{"type":"number"}}},"comparison_text":{"type":"string"},"hospital_outpatient_department":{"type":"object","properties":{"total_usd":{"type":"number"},"doctor_usd":{"type":"number"},"facility_usd":{"type":"number"},"anesthesia_usd":{"type":"number"},"lab_exam_of_tissue_usd":{"type":"number"}}},"hospital_minus_surgery_center_usd":{"type":"number"}}}},"meaning":{"type":"string"},"lab_note":{"type":"string"},"disclaimer":{"type":"string"},"approximate":{"type":"boolean"},"assumptions":{"type":"string"},"definitions":{"type":"string"},"compare_with":{"type":"string"},"approximate_note":{"type":"string"}},"description":"Medicare 2026 allowed amounts for the ZIP: surgery center versus hospital outpatient department. null when no area was found."}}}}}}},"responseSchema":{"type":"json","example":{"query":{"sort":"price","limit":1,"location":"ZIP 66210","radius_miles":25},"source":"FindMyDirectDoctor Foundation hospital cash price library (hospital price files posted under the federal price transparency rule, 45 CFR 180); CMS 2026 Physician Fee Schedule, ASC and OPPS payment files","data_as_of":"2026-10-02","disclaimer":"Posted hospital self-pay prices for the facility portion only. Final bills can differ. Confirm with the hospital.","explanations":["A colonoscopy has several separate bills: the facility (hospital or surgery center), the doctor, the anesthesia provider and, if tissue is taken, the lab. Hospital cash prices in this response cover the hospital's facility part only.","Hospital cash prices in this response cover the hospital's facility part only, so they compare with the Facility row, not with the Total row.","Prices flagged unusual are kept in the list and left out of the area median."],"hospital_cash_prices":[{"code":"45378","meaning":"a diagnostic colonoscopy (looking only, nothing taken or removed)","category":"colonoscopy","hospitals":[{"ccn":"170049","city":"Olathe","flag":"case_rate_only","name":"University of Kansas Health System Olathe Hospital","state":"KS","fap_url":"https://www.kansashealthsystem.com/patient-visitor/financial/financial-assistance","file_date":"2026-04-08","cash_price_usd":764.71,"distance_miles":9.7}],"plain_name":"Diagnostic colonoscopy (looking only)","area_prices":{"n_used":10,"low_usd":764.71,"p25_usd":926,"p75_usd":4046.96,"high_usd":4512.93,"median_usd":1578.48},"national_median_usd":1849.5,"hospitals_with_price":10},{"code":"45380","meaning":"a colonoscopy with a biopsy (a small tissue sample)","category":"colonoscopy","hospitals":[{"ccn":"170146","city":"Kansas City","flag":"","name":"Providence Medical Center","state":"KS","fap_url":"https://providencekc.com/financial-assistance/","file_date":"2026-03-17","cash_price_usd":1127,"distance_miles":13.5}],"plain_name":"Colonoscopy with a biopsy","area_prices":{"n_used":10,"low_usd":1127,"p25_usd":1201.24,"p75_usd":5807.07,"high_usd":7227.69,"median_usd":2098.28},"national_median_usd":2070.4,"hospitals_with_price":10}],"medicare_2026_benchmark":{"zip":"66210","year":2026,"basis":"the ZIP code given","codes":[{"code":"45378","note":"No lab exam of tissue is counted for this code, because no tissue is taken. If the doctor finds and removes a polyp, the bill changes to the polyp removal price.","meaning":"a diagnostic colonoscopy (looking only, nothing taken or removed)","plain_name":"Diagnostic colonoscopy (looking only)","surgery_center":{"total_usd":757,"doctor_usd":154,"facility_usd":486,"anesthesia_usd":117,"lab_exam_of_tissue_usd":0},"comparison_text":"In this area Medicare allows about $394 less at a surgery center than at a hospital outpatient department for this test.","hospital_outpatient_department":{"total_usd":1151,"doctor_usd":154,"facility_usd":880,"anesthesia_usd":117,"lab_exam_of_tissue_usd":0},"hospital_minus_surgery_center_usd":394},{"code":"45380","meaning":"a colonoscopy with a biopsy (a small tissue sample)","plain_name":"Colonoscopy with a biopsy","surgery_center":{"total_usd":974,"doctor_usd":166,"facility_usd":626,"anesthesia_usd":117,"lab_exam_of_tissue_usd":65},"comparison_text":"In this area Medicare allows about $507 less at a surgery center than at a hospital outpatient department for this test.","hospital_outpatient_department":{"total_usd":1481,"doctor_usd":166,"facility_usd":1133,"anesthesia_usd":117,"lab_exam_of_tissue_usd":65},"hospital_minus_surgery_center_usd":507}],"meaning":"This is what Medicare allows in 2026 for the test in the ZIP code area. It is not a cash price and no one has to charge it. It is a reference point set by the government from the measured cost of the work.","lab_note":"The lab amount is the full lab fee. At a hospital the lab work is often part of the facility amount, so the hospital total can be a little lower.","disclaimer":"Medicare amounts are what Medicare allows, not cash prices and not quotes. Cash prices can be above or below them. Confirm every price with the provider.","approximate":false,"assumptions":"The anesthesia amount assumes 30 minutes of anesthesia time. Real cases vary.","definitions":"A surgery center (ambulatory surgery center) is an outpatient center that is not part of a hospital. A hospital outpatient department is the part of a hospital that treats people who go home the same day. Medicare pays the facility, the doctor, the anesthesia provider and the lab as separate bills.","compare_with":"Hospital cash prices in this response cover the hospital's facility part only, so they compare with the Facility row, not with the Total row."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iNjLbnJDx-tSVKzjzy07n","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns posted hospital cash prices and Medicare 2026 benchmark amounts for four colonoscopy procedure codes near a given US location, with area medians and plain-language explanations.","exampleAgentPrompt":"Can you look up the posted hospital cash prices for a colonoscopy near ZIP 66210 within 25 miles, sorted by price, and show me how those compare to what Medicare pays at a surgery center versus a hospital outpatient department?","exampleUseCases":[{"title":"Uninsured patient comparing colonoscopy costs","prompt":"I don't have insurance and my doctor wants me to get a colonoscopy — can you find the cheapest posted hospital cash prices within 50 miles of Austin, TX and tell me roughly what the facility, doctor, and anesthesia portions might cost?"},{"title":"Employer benefits team benchmarking procedure costs","prompt":"We're building a healthcare cost guide for employees in Seattle, WA. Can you pull hospital cash prices for all four colonoscopy procedure codes within 75 miles and include the area median prices so we can see how local hospitals compare?"},{"title":"Medicare patient choosing between surgery center and hospital","prompt":"I'm on Medicare and need a screening colonoscopy near ZIP 85281 — can you show me what Medicare's 2026 allowed amounts are at an ambulatory surgery center versus a hospital outpatient department, and which local hospitals have posted their self-pay prices?"}],"resultDescription":"A JSON object containing: the interpreted query parameters; a list of up to 'limit' hospitals per colonoscopy CPT code (45378 diagnostic, 45380 with biopsy, 45385 with polyp removal, G0121 screening) with facility cash price, hospital name, city, state, distance in miles, file date, and financial assistance URL; area price statistics (low, P25, median, P75, high, n used); national median; Medicare 2026 ASC and HOPD allowed amounts broken into facility, physician, anesthesia, and lab components; plain-language explanations of the billing structure; data vintage date; and a disclaimer that prices are facility-only estimates, not quotes.","failureModes":["No hospitals found within the specified radius — try increasing radius_miles","Invalid ZIP code format (must be exactly 5 digits)","Invalid lat/lng combination outside US bounds","Missing location parameter — must provide zip, lat+lng, or city+state","Ambiguous city name without state — state is required with city","radius_miles exceeds 150 — silently capped at maximum","limit exceeds 10 — silently capped at maximum","Payment not processed (x402 micropayment required at $0.03 USDC per call)"],"whenToPreferThis":"Use this endpoint when you need hospital-posted cash prices specifically for colonoscopy procedures at a US location, including Medicare 2026 benchmark comparisons between surgery centers and hospital outpatient departments. It is preferable to general hospital price lookup tools because it covers all four colonoscopy CPT/HCPCS codes, provides area medians, and breaks the Medicare allowed amount into facility, physician, anesthesia, and lab components with plain-language explanations. Choose this over a generic price comparison tool when the user explicitly needs colonoscopy-specific pricing transparency data, is uninsured or self-pay, or is comparing care settings (ASC vs HOPD).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:20.819Z","isFirstParty":false,"canonicalSlug":"findmydirectdoctor-colonoscopy-price-estimate-api-224afeb8"}