curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-storm-events \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"state": "OK",
"county": "Cleveland",
"since": "2013-05-20",
"until": "2013-05-20",
"event_types": [
"Tornado"
]
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-storm-events", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"state": "OK",
"county": "Cleveland",
"since": "2013-05-20",
"until": "2013-05-20",
"event_types": [
"Tornado"
]
}),
});
const result = await agent.tool('lookup/place-storm-events', {
state: 'OK',
county: 'Cleveland',
since: '2013-05-20',
until: '2013-05-20',
event_types: [
'Tornado'
]
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_storm_events",
"result": {
"county_found": true,
"state": "Oklahoma",
"county": "Cleveland",
"counties": [],
"total": 1,
"truncated": false,
"events": [
{
"event_id": 451572,
"episode_id": 74673,
"event_type": "Tornado",
"begin_at": "2013-05-20T14:04:00-06:00",
"end_at": "2013-05-20T14:35:00-06:00",
"time_zone": "CST-6",
"location": "MOORE",
"area": "CLEVELAND CO.",
"area_type": "county",
"magnitude": "EF5",
"deaths": 24,
"injuries": 207,
"damage_property_usd": 2000000000,
"damage_crops_usd": 0,
"url": "https://www.ncei.noaa.gov/access/storm-events-database/event-details/451572"
}
]
},
"evidence": {
"source": "US National Oceanic and Atmospheric Administration",
"source_kind": "public",
"retrieved_at": "2026-10-27T23:18:35.000Z",
"calls": [
{
"retrieved_at": "2026-10-27T23:18:35.000Z"
},
{
"retrieved_at": "2026-10-27T23:18:35.000Z"
}
],
"as_of": null
}
}
}
Places & hazards
Storm Events
List the severe weather events recorded in a US county since a date, newest first, with magnitude, deaths, injuries and damage.
POST
/
v1
/
tools
/
lookup
/
place-storm-events
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-storm-events \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"state": "OK",
"county": "Cleveland",
"since": "2013-05-20",
"until": "2013-05-20",
"event_types": [
"Tornado"
]
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-storm-events", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"state": "OK",
"county": "Cleveland",
"since": "2013-05-20",
"until": "2013-05-20",
"event_types": [
"Tornado"
]
}),
});
const result = await agent.tool('lookup/place-storm-events', {
state: 'OK',
county: 'Cleveland',
since: '2013-05-20',
until: '2013-05-20',
event_types: [
'Tornado'
]
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_storm_events",
"result": {
"county_found": true,
"state": "Oklahoma",
"county": "Cleveland",
"counties": [],
"total": 1,
"truncated": false,
"events": [
{
"event_id": 451572,
"episode_id": 74673,
"event_type": "Tornado",
"begin_at": "2013-05-20T14:04:00-06:00",
"end_at": "2013-05-20T14:35:00-06:00",
"time_zone": "CST-6",
"location": "MOORE",
"area": "CLEVELAND CO.",
"area_type": "county",
"magnitude": "EF5",
"deaths": 24,
"injuries": 207,
"damage_property_usd": 2000000000,
"damage_crops_usd": 0,
"url": "https://www.ncei.noaa.gov/access/storm-events-database/event-details/451572"
}
]
},
"evidence": {
"source": "US National Oceanic and Atmospheric Administration",
"source_kind": "public",
"retrieved_at": "2026-10-27T23:18:35.000Z",
"calls": [
{
"retrieved_at": "2026-10-27T23:18:35.000Z"
},
{
"retrieved_at": "2026-10-27T23:18:35.000Z"
}
],
"as_of": null
}
}
}
Lists the severe weather events the US National Oceanic and Atmospheric Administration recorded in a US county, parish or independent city since 1950, newest first: type, begin and end time, location, magnitude, deaths, injuries and property and crop damage. Events appear about three months after they happen; for the last three days use Hail and Wind Reports.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
USPS state code, for example OK; DC, PR, VI, GU and AS are accepted. One of
AL, AK, AZ, AR, CA, CO, CT, DE, DC, FL, GA, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY, PR, VI, GU, AS.string
required
County, parish or independent city as the source names it, for example Cleveland, Calcasieu Parish or City of Richmond. 1 to 60 characters. Letters, digits, spaces, periods, apostrophes, parentheses and hyphens only.
string
Earliest event date; default ten years before the call. Use YYYY-MM-DD.
string
Latest event date; default the day of the call. Use YYYY-MM-DD.
string[]
Event types to return, as the source names them; omitted, every type.
integer
Most events to return. From 1 to 200. 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_storm_eventsobject
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 Oceanic and Atmospheric Administration.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 source says the fact was last updated, or
null when the source gives no dateResult
Nested underdata.result.
boolean
False when the source does not list the county for the state; then
events is empty and counties lists the names it accepts.string
The source’s state name used.
string | null
The county as the source spells it; null when not found.
string[]
When the county was not found, the source’s county names for the state, in its order; otherwise empty.
number
Events the source returned for the range, before
limit.boolean
True when the source returned its row cap: older events in the range were cut.
object[]
Events.
number
The source’s event id.
number | null
The source’s id for the episode the event belongs to.
null when the source gives no value.string
As the source words it, for example Tornado, Thunderstorm Wind or Hurricane (Typhoon).
string | null
ISO 8601 with the offset the source states; null when it does not parse.
string | null
ISO 8601 with the offset the source states; null when it does not parse.
string | null
The source’s zone label, for example CST-6.
null when the source gives no value.string | null
The place where the event began, as the source words it.
null when the source gives no value.string | null
The county or forecast zone the event is recorded on, for example CLEVELAND CO. or CLEVELAND (ZONE).
null when the source gives no value.string
Area type.
string | null
As the source gives it: hail size in inches, wind in knots (EG estimated gust, MG measured gust), tornado EF scale.
null when the source gives no value.number | null
Direct deaths.
null when the source gives no value.number | null
Direct injuries.
null when the source gives no value.number | null
Property damage in US dollars; null when not reported, never zero.
number | null
Crop damage in US dollars; null when not reported, never zero.
string
The source’s page for the event.
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-storm-events \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"state": "OK",
"county": "Cleveland",
"since": "2013-05-20",
"until": "2013-05-20",
"event_types": [
"Tornado"
]
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-storm-events", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"state": "OK",
"county": "Cleveland",
"since": "2013-05-20",
"until": "2013-05-20",
"event_types": [
"Tornado"
]
}),
});
const result = await agent.tool('lookup/place-storm-events', {
state: 'OK',
county: 'Cleveland',
since: '2013-05-20',
until: '2013-05-20',
event_types: [
'Tornado'
]
});
console.log(result.result);
console.log(result.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_storm_events",
"result": {
"county_found": true,
"state": "Oklahoma",
"county": "Cleveland",
"counties": [],
"total": 1,
"truncated": false,
"events": [
{
"event_id": 451572,
"episode_id": 74673,
"event_type": "Tornado",
"begin_at": "2013-05-20T14:04:00-06:00",
"end_at": "2013-05-20T14:35:00-06:00",
"time_zone": "CST-6",
"location": "MOORE",
"area": "CLEVELAND CO.",
"area_type": "county",
"magnitude": "EF5",
"deaths": 24,
"injuries": 207,
"damage_property_usd": 2000000000,
"damage_crops_usd": 0,
"url": "https://www.ncei.noaa.gov/access/storm-events-database/event-details/451572"
}
]
},
"evidence": {
"source": "US National Oceanic and Atmospheric Administration",
"source_kind": "public",
"retrieved_at": "2026-10-27T23:18:35.000Z",
"calls": [
{
"retrieved_at": "2026-10-27T23:18:35.000Z"
},
{
"retrieved_at": "2026-10-27T23:18:35.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
- Use it to check what hail, wind, tornado, flood or winter weather a property, a claim or a site has been through.
countymust be spelled as the source lists it (Cleveland,Calcasieu Parish,City of Richmond); case does not matter and a trailingCountymay be left off. A county the source does not list returnscounty_foundfalse andcounties, the names it accepts for that state.sinceanduntil(YYYY-MM-DD) set the dates, both inclusive; default the last ten years. Events before 1996 cover only tornado, thunderstorm wind and hail, and before 1955 only tornadoes.event_typesnarrows to the source’s types (Hail,Thunderstorm Wind,Tornado,Flash Flood, …); omitted, every type.- A county search includes events recorded on the forecast zone of the same name (
area_typezone). - Null damage means none was reported, never zero.
truncatedtrue means the source cut the answer at its row cap and older events in the range are missing: narrow the dates. - Times carry the offset the source states; it labels times in standard time all year.
- Results return inline. The finished job stays available at
/v1/requests/{request_id}