State Climate Summary returns climate information for a U.S. state when you send its full name. Provide state_name and get back the API response for that state, with the response shape determined by the service.
Use it when you need state-level climate data in an application flow, dashboard, or internal lookup without maintaining your own reference dataset. The endpoint is a straightforward read operation: one state name in, one climate summary response out.
Because the output schema is open-ended, treat the response as a structured climate summary rather than a fixed set of fields. That makes State Climate Summary useful when you want to retrieve the service's latest state-specific climate payload and pass it through to your own UI, reporting layer, or downstream logic.
Typical uses include state selectors in planning tools, regional analytics, and location-aware workflows that need a climate summary tied to a specific U.S. state.
Fetch a summary for a specific state by putting the state name in the path.
curl -X GET "http://localhost:8080/dosvak/state-climate-summary/:state_name" \
-H "apy-token: $APY_TOKEN"
What you'll get back
Returns a JSON object. The schema does not declare any specific top-level fields, so the exact response shape may vary.
{
"state_name": "CALIFORNIA",
"county_count": 35,
"avg_flood_risk": "2.2621714285714286",
"avg_heat_risk": "0E-20",
"avg_drought_risk": "0E-20",
"avg_wildfire_risk": "0E-20",
"avg_storm_risk": "0.88222857142857142857",
"avg_risk_score": "0.74198857142857142857",
"max_risk_score": "2.36305",
"attribution": [
{
"source": "NOAA NCEI",
"dataset": "Storm Events Database",
"license": "U.S. federal government data",
"url": "https://www.ncei.noaa.gov/pub/data/swdi/stormevents/csvfiles/",
"notice": "Climate risk scores are derived from NOAA storm event history and are not official NOAA risk ratings."
},
{
"source": "U.S. Census Bureau TIGER/Line",
"dataset": "TIGER/Line County Boundaries 2024",
"license": "Public domain / U.S. federal government work",
"url": "https://www2.census.gov/geo/tiger/TIGER2024/COUNTY/",
"notice": "Derived from U.S. Census Bureau TIGER/Line boundary data; not endorsed or certified by the Census Bureau."
}
]
}
TRY ITLIVE · 100 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
About this endpoint
What it does
Retrieves the climate summary for a specific state identified by its full state name. The input is the state name in the path, and the response schema is an object with additional properties allowed, but no fixed response fields are defined yet.
Path Parameter(s)
Attribute
Type
Mandatory
Description
state_name
String
Yes
Full state name.
Response
Returns a JSON object. The response schema does not define any fixed top-level fields; it allows additional properties.
Parameter
Type
Mandatory
Description
Path parameters
Name
Type
Description
state_nameREQUIRED
string
Full state name.
▣ COMMON ERRORS
Errors any endpoint can return
400bad_request
Required parameter missing or malformed body.
401unauthorized
API key missing, revoked, or not authorized for this service.
429rate_limited
Your plan's per-second rate exceeded. Retry with exponential backoff.
503upstream_busy
Backend temporarily unavailable. Try again in a few seconds.