{"uid":"cap_i6C-kDyp6KhLVi8t8m2fT","slug":"findmydirectdoctor-cash-service-price-statistics-api-1117ea6f","name":"FindMyDirectDoctor Cash Service Price Statistics API","description":"Spread of published self-pay (cash) prices for a named service across doctor's offices in a state, around a place or nationwide: lowest, median, quartiles and highest of each practice's lowest exact price, with the number of practices and a split by practice model. Medians need 5 practices and quartiles 10. These are posted prices, not what patients paid. Confirm with the practice before booking.","url":"https://api.findmydirectdoctor.com/v1/prices/cash-service-stats?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":["service"],"properties":{"lat":{"type":"number","maximum":90,"minimum":-90,"description":"Latitude; needs lng."},"lng":{"type":"number","maximum":180,"minimum":-180,"description":"Longitude; needs lat."},"zip":{"type":"string","pattern":"^\\d{5}$","description":"5-digit US ZIP code. Give zip, or lat with lng, or city with state, or state alone."},"city":{"type":"string","maxLength":80,"description":"City name; needs state."},"unit":{"enum":["auto","visit","session","unit","vial","15_min","hour","week","month","quarter","year","one_time","item"],"type":"string","default":"auto","description":"The unit compared. auto (default) = the most common unit."},"model":{"enum":["dpc","concierge","membership","cash_pay","hybrid","cash_specialist","any"],"type":"string","default":"any","description":"Practice model. cash_specialist means cash_pay. any includes unclear models."},"state":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"2-letter state code. Alone, it searches the whole state."},"service":{"type":"string","maxLength":100,"description":"The service, as a code or plain words. Codes include sports_physical, dot_physical, annual_physical, well_child, iv_therapy, weight_loss, glp1_medication, vaccines, lab_testing, ekg, imaging, telehealth_visit, home_visit, urgent_care, new_patient_visit, followup_visit, office_visit, primary_care, chronic_care, pediatrics, womens_health, mens_health, psychiatry_med_mgmt, mental_health_therapy, botox_fillers, skin_aesthetics, joint_injections_ortho, physical_therapy_chiro, nutrition_lifestyle, minor_procedures, travel_medicine, allergy_asthma, sleep_medicine, mohs_derm_surgery."},"audience":{"enum":["standard","member","child","any"],"type":"string","default":"standard","description":"standard (default) = the price for an adult who is not a member; member; child; any."},"radius_miles":{"type":"number","default":25,"maximum":100,"description":"Miles, default 25, maximum 100.","exclusiveMinimum":0}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["statistics","data_as_of"],"properties":{"note":{"type":"string"},"unit":{"type":"string"},"basis":{"type":"object","description":"How the figures were made and what was left out."},"query":{"type":"object","description":"The request as understood."},"service":{"type":"object","description":"The service as resolved."},"audience":{"type":"string"},"by_model":{"type":"object","description":"The same figures per practice model, only for models with 5 practices or more."},"data_as_of":{"type":"string"},"disclaimer":{"type":"string","description":"Prices and statements are published by the practice. Confirm with the practice before booking."},"statistics":{"type":"object","required":["n_practices"],"properties":{"low_usd":{"type":["number","null"]},"p25_usd":{"type":["number","null"],"description":"null under 10 practices."},"p75_usd":{"type":["number","null"],"description":"null under 10 practices."},"high_usd":{"type":["number","null"]},"median_usd":{"type":["number","null"],"description":"null under 5 practices."},"n_practices":{"type":"integer"}}},"source_note":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"note":"Counts are practices (not locations). Medians need 5 practices and quartiles 10; smaller samples show null. These are published prices, not what patients paid.","unit":"visit","basis":{"rule":"One value per practice: its lowest exact published price per visit. Starts-at, range, up-to and complex prices are left out.","rows_left_out":5,"practices_with_a_price":70,"practices_in_statistics":67},"query":{"unit":"visit","model":"any","scope":"TX","service":["new_patient_visit","followup_visit","office_visit"],"audience":"standard"},"service":{"label":"New-patient visit; Follow-up visit; Office visit (type not stated)","resolved":["new_patient_visit","followup_visit","office_visit"],"requested":"office visit"},"audience":"standard","by_model":{"dpc":{"low_usd":85,"p25_usd":null,"p75_usd":null,"high_usd":450,"median_usd":179,"n_practices":7},"unknown":{"low_usd":30,"p25_usd":85,"p75_usd":157.5,"high_usd":650,"median_usd":122.5,"n_practices":34},"cash_pay":{"low_usd":30,"p25_usd":63.75,"p75_usd":191.25,"high_usd":750,"median_usd":125,"n_practices":18}},"data_as_of":"2026-10-02","disclaimer":"Prices and statements are published by the practice on its own website. Confirm with the practice before booking. This is not medical, legal, tax or insurance advice.","statistics":{"low_usd":30,"p25_usd":85,"p75_usd":200,"high_usd":750,"median_usd":150,"n_practices":67},"source_note":"Facts read from each practice's own website"}},"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_-qo2kv3MxG7eGm9g0Aao9","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 statistical spread (lowest, quartiles, median, highest) of self-pay cash prices for a named medical service across doctor's offices in a state, city, or nationwide","exampleAgentPrompt":"What's the price spread for a new patient office visit at cash-pay practices in Texas — give me the lowest, median, and highest posted prices?","exampleUseCases":[{"title":"Healthcare cost research for uninsured patient","prompt":"I just lost my insurance and need to see a doctor in Florida — what's the cash price range for an office visit there, broken down by DPC vs regular cash-pay practices?"},{"title":"Employer benefits benchmarking","prompt":"We're building a self-pay health benefit for employees in California. What are the median and quartile prices for annual physicals, lab testing, and telehealth visits at any practice model in CA?"},{"title":"Price transparency tool for health app","prompt":"For ZIP code 30301 in Atlanta, what's the statistical spread of posted cash prices for urgent care visits — lowest, 25th percentile, median, 75th percentile, and highest — across all practice types?"}],"resultDescription":"A JSON object containing: the statistical distribution of self-pay cash prices (low, p25, median, p75, high in USD) across qualifying practices, the number of practices included in statistics, a breakdown of the same stats by practice model (DPC, cash_pay, unknown, etc.), the resolved service label(s) matched from the query, the geographic scope and filters applied, a note on the basis for one-value-per-practice methodology, how many rows were excluded, and a data freshness date plus disclaimer.","failureModes":["Fewer than 5 practices found for the location/service combination — median returns null","Fewer than 10 practices — quartiles return null","Service name not recognized or matched — may return empty resolved services array","Invalid state code or malformed ZIP — schema validation error","Location parameters incomplete (e.g. city without state, lat without lng) — query rejected","No published exact prices available for the service in the region — empty statistics"],"whenToPreferThis":"Use this endpoint when you need statistical benchmarks (not individual listings) of self-pay cash prices for medical services across multiple practices in a region. Ideal for price transparency research, uninsured patient cost guidance, benefits design, or building healthcare cost tools. Prefer this over individual practice lookups when you want market-level price intelligence — medians, quartiles, and ranges — filtered by state, city, ZIP, or coordinates, with optional breakdowns by practice model (DPC, cash-pay, concierge, etc.).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:30:06.273Z","isFirstParty":false,"canonicalSlug":"findmydirectdoctor-cash-service-price-statistics-api-1117ea6f"}