---
title: "Forecast by county"
method: GET
path: "/api/v1/forecast/county"
tags: ["Forecasts"]
---

# Forecast by county

`GET /api/v1/forecast/county`

## Request

- Base URL: `https://www.homecastr.com`
- URL: `https://www.homecastr.com/api/v1/forecast/county`
- Auth: none required

County-level probabilistic forecasts. Nationwide coverage. Returns P10/P25/P50/P75/P90 fan chart with growth % and growth $ fields.

## Query parameters

- `fips` string, required

## Response `200`

County forecast

- object
  - `fips` string
  - `level` 'county'
  - `origin_year` integer
  - `current_value` integer, nullable
  - `fan_chart` FanChartPoint[]
    - `year` integer
    - `horizon_months` integer
    - `p10` integer, nullable
    - `p25` integer, nullable
    - `p50` integer, nullable
    - `p75` integer, nullable
    - `p90` integer, nullable
    - `growth_pct` number, nullable
    - `growth_dollar` integer, nullable
  - `_links` object

## Other responses

- `400`: Bad request
- `404`: Not found

---

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