apyhub
GEOLOCATION · STANDARD DATA

US County Climate Profile API

What it does

County Climate Profile returns climate information for a U.S. county when you send a 5-digit county FIPS code in county_fips. The response schema is open-ended, so the API returns a climate profile object without exposing a fixed field list in the spec.

Use it when you need county-level climate context in a workflow that starts with geography. For example, you can look up a county before joining weather, land-use, insurance, agriculture, or environmental datasets keyed by FIPS. It also fits validation steps where your application needs to confirm that a county identifier can be resolved into climate-related data.

Because the endpoint is keyed by FIPS, it is easy to wire into systems that already store U.S. county records. Send the county code and use the returned climate profile in dashboards, scoring pipelines, mapping tools, or regional reporting. The API is designed for direct lookup rather than bulk analysis, so it works well as a single-record enrichment step inside larger geospatial or analytics jobs.

GET
County climate profile
http://localhost:8080/dosvak/county-climate-profile/:county_fips

QUICKSTART

GUIDE

Quickstart

Fetch the climate profile for a county by its 5-digit FIPS code.

curl -X GET "http://localhost:8080/dosvak/county-climate-profile/:county_fips" \
  -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 response shape may vary.

{
  "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",
  "updated_at": "2026-07-27T23:41:09.511395Z",
  "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.
5-digit county FIPS code.

About this endpoint

What it does

Retrieves a county climate profile for the county identified by the county_fips path parameter. The successful response is a JSON object, but the output schema does not define any fixed response fields.

Path Parameter(s)

AttributeTypeMandatoryDescription
county_fipsStringYes5-digit county FIPS code.

Response

Returns a JSON object on success. The output schema does not declare any fixed top-level fields; it only specifies an object with additional properties allowed, so the exact response shape is not captured in the schema.

Path parameters

Name
Type
Description
county_fipsREQUIRED
string
5-digit county FIPS code.
▣ 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.