▣ GEOLOCATION · STANDARD DATA

US Top Climate Risk Counties API

What it does

Top Risk Counties returns a ranked list of counties with the highest climate risk. Send an optional limit query parameter to control how many counties you get back, up to 200.

Use Top Risk Counties when you need a simple risk-ranked county list for dashboards, planning tools, or internal reporting. The response schema is open-ended, so you should treat the payload as a structured county-risk result rather than rely on fixed fields beyond the endpoint contract.

Because the output is already ordered by risk, it fits workflows that compare locations, surface high-priority areas, or feed a map and analytics layer. If you are building a climate-aware product, this endpoint gives you the high-risk county slice without requiring you to compute the ranking yourself.

GET

Top risk counties

http://localhost:8080/dosvak/top-risk-counties

QUICKSTART

GUIDE

Quickstart

Get the top risk counties with the default limit.

curl -X GET "http://localhost:8080/dosvak/top-risk-counties?limit=50" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object. The schema does not define specific response fields, so the shape may vary.

{
  "count": 1,
  "results": [
    {
      "county_fips": "06037",
      "county_name": "LOS ANGELES",
      "state_name": "CALIFORNIA",
      "flood_risk": "5.289",
      "heat_risk": "0.0",
      "drought_risk": "0.0",
      "wildfire_risk": "0.0",
      "storm_risk": "5.204",
      "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

API key

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

Returns the top risk counties, with an optional limit query parameter to control how many counties are returned.

Query Parameter(s)

Attribute	Type	Mandatory	Description
limit	Integer	No	Maximum number of counties to return. Default: `50`. Minimum: `1`. Maximum: `200`.

Response

The endpoint returns a JSON object, but the output schema does not define any specific response fields. The shape is not yet captured in the schema, so only the top-level object wrapper is known.

Query parameters

Name

Type

Description

limitOPTIONAL

integer

—

DEFAULT 50

▣ 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.