curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-hospitals \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"zip_code": "45220",
"limit": 2
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-hospitals", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"zip_code": "45220",
"limit": 2
}),
});
const result = await agent.tool('lookup/place-hospitals', {
zip_code: '45220',
limit: 2
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_hospitals",
"result": {
"total": 2,
"hospitals": [
{
"facility_id": "36003F",
"name": "CINCINNATI VA MEDICAL CENTER",
"address": "3200 VINE STREET",
"city": "CINCINNATI",
"state": "OH",
"zip_code": "45220",
"county": "HAMILTON",
"phone": "(513) 861-3100",
"type": "Acute Care - Veterans Administration",
"ownership": "Veterans Health Administration",
"emergency_services": true,
"overall_rating": 4
},
{
"facility_id": "360134",
"name": "GOOD SAMARITAN HOSPITAL",
"address": "375 DIXMYTH AVENUE",
"city": "CINCINNATI",
"state": "OH",
"zip_code": "45220",
"county": "HAMILTON",
"phone": "(513) 862-2601",
"type": "Acute Care Hospitals",
"ownership": "Voluntary non-profit - Private",
"emergency_services": true,
"overall_rating": 4
}
]
},
"evidence": {
"source": "US Centers for Medicare & Medicaid Services",
"source_kind": "public",
"retrieved_at": "2026-10-13T12:00:00.000Z",
"as_of": null
}
}
}
Lookups
Hospitals
List the hospitals registered with Medicare in a US ZIP code, with address, type, owner, emergency services and overall quality rating.
POST
/
v1
/
tools
/
lookup
/
place-hospitals
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-hospitals \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"zip_code": "45220",
"limit": 2
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-hospitals", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"zip_code": "45220",
"limit": 2
}),
});
const result = await agent.tool('lookup/place-hospitals', {
zip_code: '45220',
limit: 2
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_hospitals",
"result": {
"total": 2,
"hospitals": [
{
"facility_id": "36003F",
"name": "CINCINNATI VA MEDICAL CENTER",
"address": "3200 VINE STREET",
"city": "CINCINNATI",
"state": "OH",
"zip_code": "45220",
"county": "HAMILTON",
"phone": "(513) 861-3100",
"type": "Acute Care - Veterans Administration",
"ownership": "Veterans Health Administration",
"emergency_services": true,
"overall_rating": 4
},
{
"facility_id": "360134",
"name": "GOOD SAMARITAN HOSPITAL",
"address": "375 DIXMYTH AVENUE",
"city": "CINCINNATI",
"state": "OH",
"zip_code": "45220",
"county": "HAMILTON",
"phone": "(513) 862-2601",
"type": "Acute Care Hospitals",
"ownership": "Voluntary non-profit - Private",
"emergency_services": true,
"overall_rating": 4
}
]
},
"evidence": {
"source": "US Centers for Medicare & Medicaid Services",
"source_kind": "public",
"retrieved_at": "2026-10-13T12:00:00.000Z",
"as_of": null
}
}
}
List the hospitals registered with Medicare in a US ZIP code, from the hospital list of the US Centers for Medicare & Medicaid Services. Each hospital has its name, address, county, published main telephone line, type, ownership, whether it has emergency services and its overall quality rating from 1 to 5. The rating is null when the source gives no number for the hospital. A ZIP code with no registered hospital gives a total of 0 and an empty list. The total is the number of hospitals in the ZIP code, which can be more than the number returned.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
A five-digit US ZIP code, for example 45220. zip_code must be five digits.
integer
The most hospitals to return. Default 10. From 1 to 25. Defaults to
10.Response (200 OK)
Top-level envelope:success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status:
completedstring
Always
place_hospitalsobject
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always
US Centers for Medicare & Medicaid Services.string
public when the data comes from a public body, commercial otherwisestring
When the lookup was made, as an ISO 8601 UTC time
string
When the source says the fact was last updated, or
null when the source gives no dateResult
Nested underdata.result.
number
How many hospitals the source lists in the ZIP code.
object[]
The hospitals in the ZIP code, up to the limit. Empty when none is registered.
string
The hospital’s Medicare provider number.
string
The hospital’s name.
string
Street address.
string
City or town.
string
Two-letter state code.
string
ZIP code.
string
County or parish.
string
The hospital’s published main telephone line.
string
Kind of hospital, for example Acute Care Hospitals.
string
Who owns the hospital, for example Voluntary non-profit - Private.
boolean
Whether the hospital has emergency services, or null when the source gives no answer.
number
Overall quality rating from 1 to 5, or null when the source gives no number.
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-hospitals \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"zip_code": "45220",
"limit": 2
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-hospitals", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"zip_code": "45220",
"limit": 2
}),
});
const result = await agent.tool('lookup/place-hospitals', {
zip_code: '45220',
limit: 2
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_hospitals",
"result": {
"total": 2,
"hospitals": [
{
"facility_id": "36003F",
"name": "CINCINNATI VA MEDICAL CENTER",
"address": "3200 VINE STREET",
"city": "CINCINNATI",
"state": "OH",
"zip_code": "45220",
"county": "HAMILTON",
"phone": "(513) 861-3100",
"type": "Acute Care - Veterans Administration",
"ownership": "Veterans Health Administration",
"emergency_services": true,
"overall_rating": 4
},
{
"facility_id": "360134",
"name": "GOOD SAMARITAN HOSPITAL",
"address": "375 DIXMYTH AVENUE",
"city": "CINCINNATI",
"state": "OH",
"zip_code": "45220",
"county": "HAMILTON",
"phone": "(513) 862-2601",
"type": "Acute Care Hospitals",
"ownership": "Voluntary non-profit - Private",
"emergency_services": true,
"overall_rating": 4
}
]
},
"evidence": {
"source": "US Centers for Medicare & Medicaid Services",
"source_kind": "public",
"retrieved_at": "2026-10-13T12:00:00.000Z",
"as_of": null
}
}
}
Price: $0.005 per lookup. See Pricing for every tool.
Notes
- Results return inline. The finished job stays available at
/v1/requests/{request_id}