{"uid":"cap_jhdyFCJtryDq7uxqGpTeN","slug":"findmydirectdoctor-hospital-services-code-directory-d809fba8","name":"FindMyDirectDoctor Hospital Services Code Directory","description":"Dictionary of the 28 hospital services in the price library. Lists each CPT or HCPCS billing code with a plain name, category and the everyday words people use, and maps words such as brain MRI without contrast to a code.","url":"https://api.findmydirectdoctor.com/v1/hospital-prices/codes?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":{"q":{"type":"string","maxLength":120,"description":"Plain words to look up, for example brain mri without contrast. Returns the best code and close alternatives."},"format":{"enum":["concise","detailed"],"type":"string","default":"concise","description":"concise = key fields. detailed = every field."},"category":{"enum":["imaging","lab","emergency_room","heart_test","colonoscopy"],"type":"string","description":"Only services in this category."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["total","services","data_as_of"],"properties":{"query":{"type":"object","description":"The request as understood."},"total":{"type":"integer"},"source":{"type":"string"},"message":{"type":"string"},"resolved":{"type":["object","null"],"properties":{"code":{"type":"string"},"note":{"type":"string"},"confidence":{"type":"string"},"plain_name":{"type":"string"},"matched_phrase":{"type":["string","null"]}},"description":"The best code for q, or null when nothing matched."},"services":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"score":{"type":"number"},"family":{"type":"string"},"category":{"type":"string"},"contrast":{"type":"string"},"synonyms":{"type":"array","items":{"type":"string"}},"plain_name":{"type":"string"},"hospitals_with_price":{"type":"integer"}}}},"categories":{"type":"array","items":{"type":"string"}},"data_as_of":{"type":"string"},"how_to_use":{"type":"string"},"alternatives":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"score":{"type":"number"},"plain_name":{"type":"string"}}},"description":"Other codes that also fit the words, best first."}}}}}}},"responseSchema":{"type":"json","example":{"query":{"q":"brain mri without contrast","format":"concise"},"total":5,"source":"FindMyDirectDoctor Foundation hospital cash price library (hospital price files posted under the federal price transparency rule, 45 CFR 180)","resolved":{"code":"70551","confidence":"exact","plain_name":"Brain MRI, no contrast","matched_phrase":"brain mri"},"services":[{"code":"70551","score":1,"category":"imaging","plain_name":"Brain MRI, no contrast","hospitals_with_price":3357},{"code":"70553","score":0.8,"category":"imaging","plain_name":"Brain MRI, with and without contrast","hospitals_with_price":3345},{"code":"70450","score":0.533,"category":"imaging","plain_name":"Head CT scan, no contrast","hospitals_with_price":3498},{"code":"72148","score":0.533,"category":"imaging","plain_name":"Lower back MRI, no contrast","hospitals_with_price":3363},{"code":"73721","score":0.533,"category":"imaging","plain_name":"Knee MRI, no contrast","hospitals_with_price":3325}],"categories":["imaging","lab","emergency_room","heart_test","colonoscopy"],"data_as_of":"2026-10-02","how_to_use":"Pass code=<code> to the hospital price endpoints, or pass service=<plain words> and the same dictionary resolves it.","alternatives":[{"code":"70553","score":0.8,"plain_name":"Brain MRI, with and without contrast"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Tbd0n4pyVzo2FG3Bwzjm5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a dictionary of the 28 hospital billing codes (CPT/HCPCS) in the price library, with plain names, categories, synonyms, and keyword-to-code resolution for natural language queries.","exampleAgentPrompt":"What's the CPT billing code for a brain MRI without contrast? I want to look up hospital cash prices for it — can you search the FindMyDirectDoctor code directory and also show me any close alternatives?","exampleUseCases":[{"title":"Identify billing code before price shopping","prompt":"I need to find the right CPT code for a knee MRI without contrast so I can compare hospital cash prices. Can you look it up in the hospital services code directory and show me the best match and any alternatives?"},{"title":"Browse all imaging service codes","prompt":"Can you list every imaging service available in the hospital price library — I want to see all the CPT codes, their plain names, and how many hospitals have prices on file for each?"},{"title":"Resolve emergency room billing code","prompt":"What's the standard billing code for an emergency room visit? I want to pass the right code to a hospital price lookup — please find it in the FindMyDirectDoctor code dictionary and tell me the category and any synonyms."}],"resultDescription":"Returns the best-matched CPT/HCPCS code for a plain-language query (with confidence level and matched phrase), plus a ranked list of alternative codes. Each service entry includes the code, plain name, category, synonyms, contrast type (for imaging), relevance score, and the number of hospitals in the price database that have a price for that code. Also returns available categories, data freshness date, and instructions on how to use the codes with the hospital price endpoints.","failureModes":["Query term too vague — no code matched, resolved returns null","Category filter yields no results for the given query","Service not in the 28-code library — returns empty or partial match","Malformed query string — 400 validation error","Payment not received — 402 response blocking access"],"whenToPreferThis":"Use this endpoint when you need to translate a human-readable medical procedure description into a CPT or HCPCS billing code before querying hospital prices, or when you want to browse all available codes in the price library by category. It is the essential first step before calling the hospital price search endpoints on the same platform. Prefer this over general medical coding databases when the goal is specifically to find codes supported by FindMyDirectDoctor's hospital cash price data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:41.180Z","isFirstParty":false,"canonicalSlug":"findmydirectdoctor-hospital-services-code-directory-d809fba8"}