# FHIR Patient Search

> FHIR Patient Search is a paid API for AI agents from clonecho.builda.company, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Search patients by name on a public HL7 FHIR R4 test server, returning a FHIR-compliant Bundle of matching patient records as JSON.

## Facts

- Endpoint: POST https://clonecho.builda.company/x402/s/fhir-patient-search
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fhir-patient-search-f4b608b4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-P9gbAeQeyBiVCAgbxb0E

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 fhir-patient-search-f4b608b4 -d '<json body>'
```

Example prompt: Search the FHIR R4 test server for patients named 'Smith' and return the matching patient bundle.

## When to prefer this

Use this endpoint when you need to search for patient records by name against an HL7 FHIR R4 compliant server, especially for testing, prototyping, or demonstrating FHIR integration workflows. It is ideal when you need a standards-compliant FHIR Bundle response for patient lookup without managing your own FHIR server infrastructure.

## Known failure modes

- Empty Bundle returned when no patients match the query name
- Malformed or missing q parameter may result in an error or empty result set
- Public FHIR test server may be intermittently unavailable or rate-limited
- Query with special characters or non-ASCII names may return unexpected results
- Server may return a limited number of results without pagination support

## How this service works

Search patients by name {q} on the public HL7 FHIR R4 test server, returning a FHIR Bundle. Query: ?q= Returns JSON.

## Output

A FHIR R4 Bundle resource in JSON format containing one or more Patient resources matching the queried name, including demographic details such as name, birthdate, gender, and identifiers as available on the public test server.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fhir-patient-search-f4b608b4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from clonecho.builda.company](https://www.zero.xyz/host/clonecho.builda.company/llms.txt)