curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-hail-wind-reports \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"latitude": 35.687,
"longitude": -105.938,
"radius_km": 25,
"hours": 72,
"limit": 2
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-hail-wind-reports", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"latitude": 35.687,
"longitude": -105.938,
"radius_km": 25,
"hours": 72,
"limit": 2
}),
});
const result = await agent.tool('lookup/place-hail-wind-reports', {
latitude: 35.687,
longitude: -105.938,
radius_km: 25,
hours: 72,
limit: 2
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_hail_wind_reports",
"result": {
"total": 2,
"truncated": true,
"reports": [
{
"type": "Tstm Wnd Dmg",
"category": "wind",
"reported_at": "2026-10-25T01:10:00.000Z",
"magnitude": null,
"magnitude_units": null,
"location": "3 SW Santa Fe",
"state": "NM",
"latitude": 35.64000576594535,
"longitude": -105.980009920355,
"office": "Albuquerque NM",
"office_id": "ABQ",
"remarks": "A large mature tree, with a 1-2' trunk, was uprooted. A branch burst through a window of a residence."
},
{
"type": "Hail",
"category": "hail",
"reported_at": "2026-10-25T01:05:00.000Z",
"magnitude": 1,
"magnitude_units": "inch",
"location": "1 SW Santa Fe",
"state": "NM",
"latitude": 35.67000577078422,
"longitude": -105.97000992132457,
"office": "Albuquerque NM",
"office_id": "ABQ",
"remarks": "Dime to quarter size hail."
}
]
},
"evidence": {
"source": "US National Weather Service",
"source_kind": "public",
"retrieved_at": "2026-10-27T23:18:34.000Z",
"calls": [
{
"retrieved_at": "2026-10-27T23:18:34.000Z"
}
],
"as_of": "2026-10-27T23:14:21.000Z"
}
}
}
Places & hazards
Hail and Wind Reports
List the hail, damaging wind and tornado reports filed near a US point or in a state in the last 24, 48 or 72 hours.
POST
/
v1
/
tools
/
lookup
/
place-hail-wind-reports
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-hail-wind-reports \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"latitude": 35.687,
"longitude": -105.938,
"radius_km": 25,
"hours": 72,
"limit": 2
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-hail-wind-reports", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"latitude": 35.687,
"longitude": -105.938,
"radius_km": 25,
"hours": 72,
"limit": 2
}),
});
const result = await agent.tool('lookup/place-hail-wind-reports', {
latitude: 35.687,
longitude: -105.938,
radius_km: 25,
hours: 72,
limit: 2
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_hail_wind_reports",
"result": {
"total": 2,
"truncated": true,
"reports": [
{
"type": "Tstm Wnd Dmg",
"category": "wind",
"reported_at": "2026-10-25T01:10:00.000Z",
"magnitude": null,
"magnitude_units": null,
"location": "3 SW Santa Fe",
"state": "NM",
"latitude": 35.64000576594535,
"longitude": -105.980009920355,
"office": "Albuquerque NM",
"office_id": "ABQ",
"remarks": "A large mature tree, with a 1-2' trunk, was uprooted. A branch burst through a window of a residence."
},
{
"type": "Hail",
"category": "hail",
"reported_at": "2026-10-25T01:05:00.000Z",
"magnitude": 1,
"magnitude_units": "inch",
"location": "1 SW Santa Fe",
"state": "NM",
"latitude": 35.67000577078422,
"longitude": -105.97000992132457,
"office": "Albuquerque NM",
"office_id": "ABQ",
"remarks": "Dime to quarter size hail."
}
]
},
"evidence": {
"source": "US National Weather Service",
"source_kind": "public",
"retrieved_at": "2026-10-27T23:18:34.000Z",
"calls": [
{
"retrieved_at": "2026-10-27T23:18:34.000Z"
}
],
"as_of": "2026-10-27T23:14:21.000Z"
}
}
}
Lists the hail, damaging wind and tornado reports US National Weather Service offices filed in the last 24, 48 or 72 hours near a latitude and longitude or in a state, newest first: size or speed, time, place, office and remarks. Reports are preliminary and unverified and may repeat one event. Older reports are not kept; use Storm Events.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
number
Latitude in decimal degrees, for example 35.687. From 17 to 72.
number
Longitude in decimal degrees (west is negative), for example -105.938. From -180 to -64.
number
Distance from the point in kilometres. From 1 to 250. Defaults to
25.string
Two-letter state code, for example NM. Two capital letters.
integer
How far back to look: 24, 48 or 72. Defaults to
24.string[]
Report categories to return. Defaults to
["hail","wind","tornado"].integer
Most reports to return. From 1 to 100. Defaults to
50.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_hail_wind_reportsobject
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always
US National Weather Service.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
When the service last built its data (the latest
idp_filedate among the reports); null when nothing was reported.Result
Nested underdata.result.
number
Number of reports returned.
boolean
True when more reports matched than
limit.object[]
Reports.
string
As the source words it, for example Hail, Tstm Wnd Gst or Tornado.
string
Category.
string
ISO 8601, UTC.
number | null
Hail size or wind speed; null when the report carries none.
string | null
inch or mph.
null when the source gives no value.string | null
The source’s short place text, for example 3 SW Santa Fe.
null when the source gives no value.string | null
State.
null when the source gives no value.number | null
Latitude.
null when the source gives no value.number | null
Longitude.
null when the source gives no value.string | null
The forecast office that filed it, for example Albuquerque NM.
null when the source gives no value.string | null
The office code, for example ABQ.
null when the source gives no value.string | null
Remarks.
null when the source gives no value.curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-hail-wind-reports \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"latitude": 35.687,
"longitude": -105.938,
"radius_km": 25,
"hours": 72,
"limit": 2
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-hail-wind-reports", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"latitude": 35.687,
"longitude": -105.938,
"radius_km": 25,
"hours": 72,
"limit": 2
}),
});
const result = await agent.tool('lookup/place-hail-wind-reports', {
latitude: 35.687,
longitude: -105.938,
radius_km: 25,
hours: 72,
limit: 2
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_hail_wind_reports",
"result": {
"total": 2,
"truncated": true,
"reports": [
{
"type": "Tstm Wnd Dmg",
"category": "wind",
"reported_at": "2026-10-25T01:10:00.000Z",
"magnitude": null,
"magnitude_units": null,
"location": "3 SW Santa Fe",
"state": "NM",
"latitude": 35.64000576594535,
"longitude": -105.980009920355,
"office": "Albuquerque NM",
"office_id": "ABQ",
"remarks": "A large mature tree, with a 1-2' trunk, was uprooted. A branch burst through a window of a residence."
},
{
"type": "Hail",
"category": "hail",
"reported_at": "2026-10-25T01:05:00.000Z",
"magnitude": 1,
"magnitude_units": "inch",
"location": "1 SW Santa Fe",
"state": "NM",
"latitude": 35.67000577078422,
"longitude": -105.97000992132457,
"office": "Albuquerque NM",
"office_id": "ABQ",
"remarks": "Dime to quarter size hail."
}
]
},
"evidence": {
"source": "US National Weather Service",
"source_kind": "public",
"retrieved_at": "2026-10-27T23:18:34.000Z",
"calls": [
{
"retrieved_at": "2026-10-27T23:18:34.000Z"
}
],
"as_of": "2026-10-27T23:14:21.000Z"
}
}
}
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
- Use it to check whether hail, a damaging gust or a tornado was reported near a property, a claim site or a route stop in the last day or three.
- Give a point (
latitude,longitude, withradius_km1 to 250, default 25) or astate(two-letter code), not both. hoursis 24, 48 or 72 (default 24).typesnarrows tohail,windortornado; default all three.magnitudeis hail size in inches or wind speed in mph (magnitude_unitssays which); damage and tornado reports carry no magnitude.locationis the source’s short place text, cut at 23 characters.truncatedtrue means more reports matched thanlimit.- A point or state with nothing reported is a completed result with
total0. - Results return inline. The finished job stays available at
/v1/requests/{request_id}