# OneShot Agent API – Hospital Lookup by ZIP Code

> OneShot Agent API – Hospital Lookup by ZIP Code is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-28).

Returns a list of US hospitals near a given ZIP code, including facility details, ratings, and emergency services availability.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/lookup/place-hospitals?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-api-hospital-lookup-by-zip-code-7fd464de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6koiv_f-d0i9v0PXgQjzP

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 oneshot-agent-api-hospital-lookup-by-zip-code-7fd464de -d '<json body>'
```

Example prompt: Can you find me the top 5 hospitals near ZIP code 45220, including whether they have emergency services?

## When to prefer this

Use this endpoint when you need structured US hospital data — including ratings, emergency services, and ownership — indexed by ZIP code. Ideal for healthcare navigation, insurance research, emergency planning, or agent workflows that need local facility data without requiring an API key, paying only $0.005 USDC per call via x402 on Base.

## Known failure modes

- Invalid or non-existent ZIP code returns empty hospital list or error
- ZIP code not in US format causes validation failure
- Limit parameter set to 0 or negative may return empty results or error
- Payment failure via x402 protocol blocks the request
- Exceeding rate limits or insufficient USDC balance prevents call completion

## How this service works

List the hospitals registered with Medicare in a US ZIP code, with address, type, owner, emergency services and overall quality rating.

## Output

Returns a JSON object with a total count and an array of hospital records, each containing the hospital name, type, address, city, state, county, ZIP code, phone number, facility ID, overall rating (numeric), emergency services availability (boolean), and ownership category.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "The most hospitals to return. From 1 to 25. Defaults to `10`."
  },
  "zip_code": {
   "type": "string",
   "description": "A US ZIP code, for example 45220. zip_code must be five digits."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 2,
  "hospitals": [
   {
    "city": "CINCINNATI",
    "name": "CINCINNATI VA MEDICAL CENTER",
    "type": "Acute Care - Veterans Administration",
    "phone": "(513) 861-3100",
    "state": "OH",
    "county": "HAMILTON",
    "address": "3200 VINE STREET",
    "zip_code": "45220",
    "ownership": "Veterans Health Administration",
    "facility_id": "36003F",
    "overall_rating": 4,
    "emergency_services": true
   },
   {
    "city": "CINCINNATI",
    "name": "GOOD SAMARITAN HOSPITAL",
    "type": "Acute Care Hospitals",
    "phone": "(513) 862-2601",
    "state": "OH",
    "county": "HAMILTON",
    "address": "375 DIXMYTH AVENUE",
    "zip_code": "45220",
    "ownership": "Voluntary non-profit - Private",
    "facility_id": "360134",
    "overall_rating": 4,
    "emergency_services": true
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-api-hospital-lookup-by-zip-code-7fd464de/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)