apyhub
GEOLOCATION · STANDARD DATA

US County Profile API

What it does

County Profile lets you fetch a county profile by 5-digit FIPS code. Send the county_fips path value and get a JSON response for that county back.

Use County Profile when you need a reliable lookup step in address intelligence, demographic enrichment, reporting, or internal admin tools. A single request is enough to resolve one county identifier into the profile payload exposed by the API.

The endpoint accepts one input: county_fips. The code must be a 5-digit county FIPS string such as 06037. The response includes the county profile, including the county FIPS code, county name, state name, population, demographic metrics, last updated timestamp, and attribution information.

This is a good fit for systems that store county codes and need to retrieve the associated profile on demand, rather than maintaining a local copy of reference data.

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

QUICKSTART

GUIDE

Quickstart

Fetch a county profile by providing the 5-digit county FIPS code in the path.

curl -X GET "http://localhost:8080/dosvak/county-profile/:county_fips" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object containing the county profile, including the county FIPS code, county name, state name, population, demographic metrics, last updated timestamp, and attribution information.

{
  "county_fips": "06037",
  "county_name": "Los Angeles County",
  "state_name": "California",
  "population": 9757179,
  "median_household_income": "80794",
  "poverty_rate": "13.1",
  "unemployment_rate": "5.4",
  "updated_at": "2026-07-27T23:40:59Z",
  "attribution": [
    {
      "source": "U.S. Census Bureau Population Estimates Program"
    }
  ]
}
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

Returns the county profile for a specified county FIPS code. The request identifies the county by its 5-digit FIPS value in the path.

Path Parameter(s)

AttributeTypeMandatoryDescription
county_fipsStringYes5-digit county FIPS code.

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.