curl -X POST https://win.oneshotagent.com/v1/tools/lookup/company-care-quality \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"facility_type": "hospital",
"ccn": "240010"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/company-care-quality", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"facility_type": "hospital",
"ccn": "240010"
}),
});
const result = await agent.tool('lookup/company-care-quality', {
facility_type: 'hospital',
ccn: '240010'
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "company_care_quality",
"result": {
"facility_type": "hospital",
"rating_name": "Overall hospital quality star rating",
"has_more": false,
"facilities": [
{
"ccn": "240010",
"name": "MAYO CLINIC HOSPITAL ROCHESTER",
"city": "ROCHESTER",
"state": "MN",
"zip_code": "55902",
"ownership": "Voluntary non-profit - Church",
"chain": null,
"overall_rating": 5,
"overall_rating_footnote": null,
"component_ratings": null,
"special_focus_status": null,
"abuse_cited": null,
"rating_period": null
}
]
},
"evidence": {
"source": "US Centers for Medicare & Medicaid Services",
"source_kind": "public",
"retrieved_at": "2026-10-27T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-27T12:00:00.000Z"
}
],
"as_of": null
}
}
}
Health
Care Quality Ratings
Look up official Medicare star ratings for a care facility.
POST
/
v1
/
tools
/
lookup
/
company-care-quality
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/company-care-quality \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"facility_type": "hospital",
"ccn": "240010"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/company-care-quality", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"facility_type": "hospital",
"ccn": "240010"
}),
});
const result = await agent.tool('lookup/company-care-quality', {
facility_type: 'hospital',
ccn: '240010'
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "company_care_quality",
"result": {
"facility_type": "hospital",
"rating_name": "Overall hospital quality star rating",
"has_more": false,
"facilities": [
{
"ccn": "240010",
"name": "MAYO CLINIC HOSPITAL ROCHESTER",
"city": "ROCHESTER",
"state": "MN",
"zip_code": "55902",
"ownership": "Voluntary non-profit - Church",
"chain": null,
"overall_rating": 5,
"overall_rating_footnote": null,
"component_ratings": null,
"special_focus_status": null,
"abuse_cited": null,
"rating_period": null
}
]
},
"evidence": {
"source": "US Centers for Medicare & Medicaid Services",
"source_kind": "public",
"retrieved_at": "2026-10-27T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-27T12:00:00.000Z"
}
],
"as_of": null
}
}
}
Returns official star ratings of a US hospital, nursing home, home health agency, hospice or dialysis facility by CMS Certification Number or name, from the US Centers for Medicare & Medicaid Services: overall rating from 1 to 5, plus nursing home inspection, quality and staffing ratings. A null rating means the source published none.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
Which register to read; each kind of facility is rated in its own dataset. One of
hospital, nursing_home, home_health, hospice, dialysis.string
The facility CMS Certification Number (Medicare provider number). A CMS Certification Number is six digits or capital letters.
string
Case-insensitive substring of the facility name. 3 to 100 characters.
string
State abbreviation; only with facility_name.
integer
Most facilities to return. From 1 to 10. Defaults to
5.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
company_care_qualityobject
The answer, described under Result below
object
Where the answer came from and when
boolean
true when the answer was served from OneShot’s store of earlier lookups (or its own copy of a public dataset), false when the source was asked for this callstring
When the record was obtained from its source, as an ISO 8601 UTC time; equals
evidence.retrieved_atstring
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 | null
For nursing homes, the date the source processed the register release that answered; null for other facility types, whose rows carry no date.
Result
Nested underdata.result.
string
Facility type.
string
Rating name.
boolean
Has more.
object[]
Facilities.
string
Ccn.
string
Name.
string | null
City.
null when the source gives no value.string | null
State.
null when the source gives no value.string | null
Zip code.
null when the source gives no value.string | null
Ownership.
null when the source gives no value.string | null
Chain.
null when the source gives no value.integer | null
Overall rating.
null when the source gives no value.string | null
Overall rating footnote.
null when the source gives no value.object | null
Component ratings.
null when the source gives no value.integer | null
Health inspection.
null when the source gives no value.integer | null
Quality measures.
null when the source gives no value.integer | null
Long stay quality.
null when the source gives no value.integer | null
Short stay quality.
null when the source gives no value.integer | null
Staffing.
null when the source gives no value.string | null
Special focus status.
null when the source gives no value.boolean | null
Abuse cited.
null when the source gives no value.string | null
Rating period.
null when the source gives no value.curl -X POST https://win.oneshotagent.com/v1/tools/lookup/company-care-quality \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"facility_type": "hospital",
"ccn": "240010"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/company-care-quality", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"facility_type": "hospital",
"ccn": "240010"
}),
});
const result = await agent.tool('lookup/company-care-quality', {
facility_type: 'hospital',
ccn: '240010'
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "company_care_quality",
"result": {
"facility_type": "hospital",
"rating_name": "Overall hospital quality star rating",
"has_more": false,
"facilities": [
{
"ccn": "240010",
"name": "MAYO CLINIC HOSPITAL ROCHESTER",
"city": "ROCHESTER",
"state": "MN",
"zip_code": "55902",
"ownership": "Voluntary non-profit - Church",
"chain": null,
"overall_rating": 5,
"overall_rating_footnote": null,
"component_ratings": null,
"special_focus_status": null,
"abuse_cited": null,
"rating_period": null
}
]
},
"evidence": {
"source": "US Centers for Medicare & Medicaid Services",
"source_kind": "public",
"retrieved_at": "2026-10-27T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-27T12:00:00.000Z"
}
],
"as_of": null
}
}
}
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers
200.Notes
- rating_name identifies the rating for each facility_type: hospital overall quality, nursing home overall five-star, home health patient care quality, hospice family caregiver survey summary, or dialysis facility five-star.
- Names match substrings; use has_more and the CCN to distinguish facilities. No match completes with facilities: [].
- Use place_hospitals to list hospitals in a ZIP code and company_medicare_ownership for ownership details. Only the current release is served; history begins with our first observation.
- Results return inline. The finished job stays available at
/v1/requests/{request_id}