---
title: "Detailed view for a single county"
method: GET
path: "/api/v1/market/counties/{fips}"
tags: ["Market"]
---

# Detailed view for a single county

`GET /api/v1/market/counties/{fips}`

## Request

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

Returns the full county profile: quarterly market stats (sale count, median price, YoY change, days on market), affordability index by year, parcel summary (count, avg assessed value), and flip activity. Use for county-detail dashboards.

## Path parameters

- `fips` string, required

## Response `200`

County detail returned.

- CountyDetail
  - `county_fips` string, required
  - `market_stats` object[], required
    - `county_fips` string, required
    - `state_fips` string, required
    - `quarter` string, nullable, required
    - `sale_count` integer, nullable, required
    - `median_sale_price` number, nullable, required
    - `avg_sale_price` number, nullable, required
    - `total_volume` integer, nullable, required
    - `price_yoy_pct` number, nullable, required
    - `avg_dom` number, nullable, required: Average days on market.
    - `refreshed_at` string, nullable, required
    - `under_review` string[]
    - `stale_quarter` boolean, nullable
  - `affordability` AffordabilityRow[], required
    - `county_fips` string, required
    - `median_household_income` number, nullable, required
    - `median_sale_price` number, nullable, required
    - `price_to_income_ratio` number, nullable, required
    - `affordability_rating` 'AFFORDABLE' | 'MODERATE' | 'EXPENSIVE' | 'VERY_EXPENSIVE' | 'null', nullable, required
    - `year` integer, nullable, required
    - `refreshed_at` string, nullable, required
    - `state_fips` string
    - `county_name` string, nullable
    - `monthly_payment_estimate` number, nullable
    - `pct_income_for_housing` number, nullable
  - `data_provenance` object, required
    - `market` object, required
      - `dataset` string, nullable, required
      - `period_upper_bound` string, nullable, required
      - `returned_records` number, nullable, required
      - `oldest_record_refresh` string, nullable, required
      - `newest_record_refresh` string, nullable, required
      - `records_without_refresh` number, nullable, required
      - `source_vintage` string, nullable, required
      - `basis` string, nullable, required
    - `affordability` object, required
      - `dataset` string, nullable, required
      - `period_upper_bound` number, nullable, required
      - `returned_records` number, nullable, required
      - `oldest_record_refresh` string, nullable, required
      - `newest_record_refresh` string, nullable, required
      - `records_without_refresh` number, nullable, required
      - `source_vintage` string, nullable, required
      - `income_measure` object, required
        - `stored_field` string, nullable, required
        - `interpretation` string, nullable, required
        - `source_tax_year` string, nullable, required
        - `source_lineage_verified` boolean, nullable, required
        - `limitations` string, nullable, required
      - `basis` string, nullable, required
  - `parcel_summary` object, required
    - `parcel_count` integer, nullable, required
    - `avg_assessed_value` number, nullable, required
  - `flip_summary` object, required
    - `flip_count` integer, nullable, required
    - `avg_roi` number, nullable, required
    - `avg_hold_days` number, nullable, required
    - `total_profit` number, nullable, required

## Other responses

- `400`: Invalid FIPS code.
- `401`: Missing, malformed or invalid credential.
- `404`: The resource (or the endpoint) does not exist.
- `405`: The endpoint exists but does not support this method. `Allow` lists the methods it does.
- `429`: Rate limit exceeded.
- `500`: Unexpected server error. The body never carries database or driver text.

---

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