---
title: US County Directory API
slug: list-counties
url: https://apyhub.com/dosvak/service/list-counties
provider: Dosvak LLC
categories: [Geolocation, Standard Data]
tags: [counties, county-directory, reference-data, us-geography, state-filtering]
auth: api_key
---

# US County Directory API

List US counties with optional state_name and limit filters. Built for address forms, regional lookups, and US geography reference data.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/dosvak/list-counties` | What it does Returns a JSON object containing the counties listing response. The output schema does… | 100 |

## Examples

### List counties

#### Quickstart

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

```bash
curl -X GET "https://api.eu.apyhub.com/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.

```json
{
  "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": []
}
```

## About

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

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/dosvak/service/list-counties