Api Endpoint

hospital-price-lookup

Negotiated, gross and cash prices a hospital publishes for a procedure code, plus fused CMS Care Compare quality. Streams the slice of the hospital's own machine-readable file for one billing code and cites the file's hospital name, date and version. Informational, not a quote.

Open interactive test console

Offering

Provider
payai.agentstools.dev
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Health And Medicine
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://payai.agentstools.dev/price/hospital
MIME type
application/json
First seen
2026-10-16T02:01:07.550Z
Last seen
Tags
hospital, Price, negotiated-rate, cash-price, gross-charge, CMS, care-compare, quality, procedure, healthcare, mrf, fusion

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.04 USDC
Atomic price: 40000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.04 USDC
Atomic price: 40000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "40000",
    "payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "40000",
    "payTo": "AytHnvc6bZx1ALTy7b5Px7hcavoSYszG9aeKvDcZ8R1u"
  }
]

Observed health

Status
Healthy
Latest latency
404 ms
Average latency
872 ms
HTTP status
402
Last checked
Reachability
100% over 9 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "HEAD",
        "DELETE"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "description": "Procedure billing code to look up, e.g. 27447"
        },
        "code_type": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "CPT",
              "HCPCS",
              "MS-DRG",
              "DRG",
              "APC",
              "NDC",
              "ICD-10",
              "CDM",
              "local"
            ]
          },
          "description": "Optional billing-code system(s) to constrain the match"
        },
        "mrf_url": {
          "type": "string",
          "description": "The hospital machine-readable-file URL (from /price/discover)"
        },
        "domain": {
          "type": "string",
          "description": "Hospital domain to auto-discover the MRF instead of mrf_url"
        },
        "payer": {
          "type": "string",
          "description": "Optional payer or plan name substring to filter the returned negotiated rates"
        },
        "ccn": {
          "type": "string",
          "description": "Optional 6-digit CMS Certification Number to fuse Care Compare quality"
        }
      },
      "required": [
        "code"
      ]
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "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": [
            "code"
          ],
          "properties": {
            "ccn": {
              "type": "string",
              "description": "Optional 6-digit CMS Certification Number to fuse Care Compare quality"
            },
            "code": {
              "type": "string",
              "description": "Procedure billing code to look up, e.g. 27447"
            },
            "payer": {
              "type": "string",
              "description": "Optional payer or plan name substring to filter the returned negotiated rates"
            },
            "domain": {
              "type": "string",
              "description": "Hospital domain to auto-discover the MRF instead of mrf_url"
            },
            "mrf_url": {
              "type": "string",
              "description": "The hospital machine-readable-file URL (from /price/discover)"
            },
            "code_type": {
              "type": "array",
              "items": {
                "enum": [
                  "CPT",
                  "HCPCS",
                  "MS-DRG",
                  "DRG",
                  "APC",
                  "NDC",
                  "ICD-10",
                  "CDM",
                  "local"
                ],
                "type": "string"
              },
              "description": "Optional billing-code system(s) to constrain the match"
            }
          }
        }
      },
      "additionalProperties": false
    },
    "output": {
      "type": "object",
      "required": [
        "type"
      ],
      "properties": {
        "type": {
          "type": "string"
        },
        "example": {
          "type": "object"
        }
      }
    }
  }
}