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.
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.
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)
Attribute
Type
Mandatory
Description
county_fips
String
Yes
5-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.