Atlasblock API

POST/v1/counties/verify

Resolve a county by FIPS, or by name + state (tolerates the "County" suffix).

[ OPTIONS ]
NameTypeRequiredDescription
county_fipsstring (body)No5-digit county FIPS. Use this or name + state.
namestring (body)NoCounty name, with or without "County" (e.g. Mecklenburg).
statestring (body)NoUSPS state code for the name lookup.
[ EXAMPLE REQUEST ]
curl -X POST "https://atlasblock.dev/api/v1/counties/verify" \
  -H "Content-Type: application/json" \
  -d '{"name":"Mecklenburg","state":"NC"}'
[ 200 OK ]
{
  "status": "success",
  "data": {
    "valid": true,
    "county": {
      "county_fips": "37119",
      "county": "Mecklenburg County",
      "state": "NC"
    }
  }
}
POST/v1/counties/verify
[ BODY · JSON ]
  • county_fips · string (body)5-digit county FIPS. Use this or name + state.
  • name · string (body)County name, with or without "County" (e.g. Mecklenburg).
  • state · string (body)USPS state code for the name lookup.
[ CURL ]
curl -X POST "https://atlasblock.dev/api/v1/counties/verify" \
  -H "Authorization: Bearer $ATLASBLOCK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Mecklenburg","state":"NC"}'
[ EVERY REQUEST ]

Send an Authorization: Bearer key against the base URL https://atlasblock.dev/api. Every call counts toward your plan quota. See the overview for authentication, rate limits, and status codes.