▣ GEOLOCATION · STANDARD DATA

US County Directory API

What it does

County Directory lists counties and lets you filter them by state name. Send an optional limit to control how many records you get back, and an optional state_name to narrow the results to a specific state such as California.

Use County Directory when you need county reference data for address forms, regional filters, dashboards, or internal lookup tools. It is a simple read endpoint for retrieving county lists without having to maintain your own dataset.

The response includes the total number of matching counties, a list of county records, and attribution information., so the service returns a county listing in a structured JSON object without exposing a fixed set of fields in the contract here. That makes it useful for cataloging and browsing county data while keeping your integration lightweight.

If your workflow depends on US administrative geography, County Directory gives you a straightforward way to fetch county data on demand and scope it to a state when needed.

GET

List counties

http://localhost:8080/dosvak/list-counties

QUICKSTART

GUIDE

Quickstart

Fetch counties, optionally filtering by state name, with a simple GET request.

curl -X GET "http://localhost:8080/dosvak/list-counties?limit=100&state_name=California" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object containing the number of matching counties, a list of county records, and attribution details.

{
  "count": 2,
  "results": [
    {
      "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"
    },
    {
      "county_fips": "06073",
      "county_name": "San Diego County",
      "state_name": "California",
      "population": 3298799,
      "median_household_income": null,
      "poverty_rate": null,
      "unemployment_rate": null
    }
  ],
  "attribution": []
}

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 a JSON object containing the counties listing response. The output schema does not define any fixed top-level fields, so the exact response shape is not yet captured in the schema.

Query Parameter(s)

Attribute	Type	Mandatory	Description
limit	Integer	No	Maximum number of items to return. Default: `100`. Minimum: `1`. Maximum: `500`.
state_name	String	No	State name to filter by. Nullable.

Response

Returns a JSON object containing the number of matching counties, a list of county records, and attribution details.

Query parameters

Name

Type

Description

limitOPTIONAL

integer

—

DEFAULT 100

state_nameOPTIONAL

string

—

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