# FindMyDirectDoctor Hospital Services Code Directory

> FindMyDirectDoctor Hospital Services Code Directory is a paid API for AI agents from api.findmydirectdoctor.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-31).

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.

## Facts

- Endpoint: GET https://api.findmydirectdoctor.com/v1/hospital-prices/codes?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/findmydirectdoctor-hospital-services-code-directory-d809fba8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jhdyFCJtryDq7uxqGpTeN

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability findmydirectdoctor-hospital-services-code-directory-d809fba8
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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": {
          "
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/findmydirectdoctor-hospital-services-code-directory-d809fba8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.findmydirectdoctor.com](https://www.zero.xyz/host/api.findmydirectdoctor.com/llms.txt)