curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-disasters \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"state": "TX",
"county": "Harris",
"incident_type": "Hurricane",
"declared_after": "2015-01-01",
"declared_before": "2024-12-31",
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-disasters", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"state": "TX",
"county": "Harris",
"incident_type": "Hurricane",
"declared_after": "2015-01-01",
"declared_before": "2024-12-31",
"limit": 1
}),
});
const result = await agent.tool('lookup/place-disasters', {
state: 'TX',
county: 'Harris',
incident_type: 'Hurricane',
declared_after: '2015-01-01',
declared_before: '2024-12-31',
limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_disasters",
"result": {
"state": "TX",
"county": "Harris",
"total": 4,
"declarations": [
{
"declaration_id": "DR-4798-TX",
"kind": "major_disaster",
"declared_on": "2024-07-09",
"incident_type": "Hurricane",
"title": "HURRICANE BERYL",
"incident_began_on": "2024-07-05",
"incident_ended_on": "2024-07-09",
"area": "Harris (County)",
"statewide": false,
"individual_assistance": true,
"public_assistance": true,
"hazard_mitigation": true
}
]
},
"evidence": {
"source": "US Federal Emergency Management Agency",
"source_kind": "public",
"retrieved_at": "2026-01-15T12:00:00.000Z",
"as_of": null
}
}
}
Lookups
Disaster Declarations
List the federal disaster declarations that covered a US county.
POST
/
v1
/
tools
/
lookup
/
place-disasters
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-disasters \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"state": "TX",
"county": "Harris",
"incident_type": "Hurricane",
"declared_after": "2015-01-01",
"declared_before": "2024-12-31",
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-disasters", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"state": "TX",
"county": "Harris",
"incident_type": "Hurricane",
"declared_after": "2015-01-01",
"declared_before": "2024-12-31",
"limit": 1
}),
});
const result = await agent.tool('lookup/place-disasters', {
state: 'TX',
county: 'Harris',
incident_type: 'Hurricane',
declared_after: '2015-01-01',
declared_before: '2024-12-31',
limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_disasters",
"result": {
"state": "TX",
"county": "Harris",
"total": 4,
"declarations": [
{
"declaration_id": "DR-4798-TX",
"kind": "major_disaster",
"declared_on": "2024-07-09",
"incident_type": "Hurricane",
"title": "HURRICANE BERYL",
"incident_began_on": "2024-07-05",
"incident_ended_on": "2024-07-09",
"area": "Harris (County)",
"statewide": false,
"individual_assistance": true,
"public_assistance": true,
"hazard_mitigation": true
}
]
},
"evidence": {
"source": "US Federal Emergency Management Agency",
"source_kind": "public",
"retrieved_at": "2026-01-15T12:00:00.000Z",
"as_of": null
}
}
}
List the federal disaster declarations (floods, hurricanes, fires, storms, earthquakes and more) that covered a US county, newest first. Use it to check the hazard history of a property, a policy or a claim location. Both
state and county are required. Declarations that cover a whole state are included for every county in it and marked statewide. total is the number of matching declarations, which can exceed the page returned when limit is lower. Narrow with incident_type (for example Flood, Hurricane, Fire) and a declaration date range. A county with no declarations is a completed result with total 0.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
Two-letter state postal code, for example TX. A state is its two-letter postal code, for example TX.
string
required
County or parish name without the word County or Parish, for example Harris. A county name has 2 to 40 letters, spaces, periods, apostrophes and hyphens, without “County” or “Parish”.
string
Only declarations for this incident type, for example Flood, Hurricane, Fire, Tornado, Severe Storm. An incident type is words such as Flood, Hurricane or Fire.
string
Only declarations made on or after this date (YYYY-MM-DD). Use YYYY-MM-DD.
string
Only declarations made on or before this date (YYYY-MM-DD). Use YYYY-MM-DD.
integer
Most declarations to return, newest first. Default 25. From 1 to 100.
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_disastersobject
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always
US Federal Emergency Management Agency.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.
string
State.
string
County.
number
Every declaration matching the search, not only the ones returned.
object[]
Declarations.
string
The FEMA declaration number, for example DR-4798-TX.
null when the source gives no value.string
major_disaster, emergency, fire_management, or the raw declaration code.
null when the source gives no value.string
YYYY-MM-DD.
null when the source gives no value.string
Incident type.
null when the source gives no value.string
Title.
null when the source gives no value.string
YYYY-MM-DD.
null when the source gives no value.string
YYYY-MM-DD; null while the incident is open.
string
The designated area as FEMA names it, for example Harris (County) or Statewide.
null when the source gives no value.boolean
True when the declaration covers the whole state.
boolean
Assistance to individuals declared (Individual Assistance or Individuals and Households program).
null when the source gives no value.boolean
Public assistance program declared.
null when the source gives no value.boolean
Hazard mitigation program declared.
null when the source gives no value.curl -X POST https://win.oneshotagent.com/v1/tools/lookup/place-disasters \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"state": "TX",
"county": "Harris",
"incident_type": "Hurricane",
"declared_after": "2015-01-01",
"declared_before": "2024-12-31",
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/place-disasters", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"state": "TX",
"county": "Harris",
"incident_type": "Hurricane",
"declared_after": "2015-01-01",
"declared_before": "2024-12-31",
"limit": 1
}),
});
const result = await agent.tool('lookup/place-disasters', {
state: 'TX',
county: 'Harris',
incident_type: 'Hurricane',
declared_after: '2015-01-01',
declared_before: '2024-12-31',
limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "place_disasters",
"result": {
"state": "TX",
"county": "Harris",
"total": 4,
"declarations": [
{
"declaration_id": "DR-4798-TX",
"kind": "major_disaster",
"declared_on": "2024-07-09",
"incident_type": "Hurricane",
"title": "HURRICANE BERYL",
"incident_began_on": "2024-07-05",
"incident_ended_on": "2024-07-09",
"area": "Harris (County)",
"statewide": false,
"individual_assistance": true,
"public_assistance": true,
"hazard_mitigation": true
}
]
},
"evidence": {
"source": "US Federal Emergency Management Agency",
"source_kind": "public",
"retrieved_at": "2026-01-15T12: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}