---
title: "One county, decoded, by FIPS code or name."
method: GET
path: "/api/v1/counties/{county}"
---

# One county, decoded, by FIPS code or name.

`GET /api/v1/counties/{county}`

## Request

- Base URL: `https://tickerfacts.com`
- URL: `https://tickerfacts.com/api/v1/counties/{county}`
- Auth: one of:
  - none
  - HTTP bearer

## Path parameters

- `county` string, required

## Response `200`

Labelled ACS characteristics with 90% margins of error and QCEW industry employment, or a candidate list when the name is ambiguous.

- union
  - CountyContext
    - `accuracy_url` string, nullable
    - `built_at` string, required
    - `id` string, required: County FIPS code.
    - `interpretation` string, required
    - `name` string, required
    - `notes` string[], required
    - `population` object, nullable, required
    - `private_industry_employment` CountyIndustry[], required
      - `annual_pay_usd` number, nullable, required
      - `disclosure` string, nullable, required
      - `job_growth_pct` number, nullable, required
      - `jobs` number, nullable, required
      - `label` string, nullable, required
      - `naics` string, required
      - `national` object: The same columns for the whole country.
      - `weekly_wage_usd` number, nullable, required
    - `resident_characteristics` object[], required
      - `id` string, required
      - `kind` string, nullable
      - `label` string, required
      - `margin_of_error_90pct` number, nullable, required
      - `period` string, nullable
      - `price_basis` string, nullable
      - `source` string, nullable
      - `uncertainty` string, nullable
      - `unit` string, nullable
      - `universe` string, nullable
      - `value` number, nullable, required: Null means unavailable, not zero.
    - `sources` object[], required
    - `state` string, required
    - `state_name` string, required
    - `version` integer
  - CountyCandidates
    - `ambiguous` unknown, required
    - `candidates` object[], required
      - `id` string, required
      - `name` string, required
      - `state` string, required
      - `state_name` string, required
    - `hint` string, required
    - `match_count` integer, required
    - `query` string, required
    - `showing` integer, required

## Other responses

- `404`: No county matches.

---

[API](https://skmtc.dev/tickerfacts/apis/tickerfacts-json-api.md) · [All operations](https://skmtc.dev/tickerfacts/apis/tickerfacts-json-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tickerfacts/apis/tickerfacts-json-api/revisions/bc6cb5e92b7f?raw)