---
title: "Market snapshot for a geography"
method: GET
path: "/api/v1/market/snapshot"
tags: ["Market"]
---

# Market snapshot for a geography

`GET /api/v1/market/snapshot`

## Request

- Base URL: `https://propraven.com`
- URL: `https://propraven.com/api/v1/market/snapshot`
- Auth: HTTP bearer

Demographics, economy, housing, lending, hazard and market context for exactly one geography: a county, census tract, CBSA or ZIP.

## Query parameters

- `county_fips` string
- `tract` string
- `cbsa` string
- `zip` string

## Response `200`

The snapshot.

- object
  - `geo` object, required
    - `scope` string, nullable, required
    - `value` string, nullable, required
    - `state_fips` string, required
    - `county_fips` string, required
    - `county_name` string, nullable, required
    - `state` string, nullable, required
    - `cbsa_code` string, nullable, required
    - `census_tract` string, nullable, required
    - `zip5` string, nullable, required
    - `geo_basis` string, required
    - `geo_basis_withheld` string[], required
  - `demographics` object, required
    - `acs_median_hh_income` number, nullable, required
    - `acs_median_home_value` number, nullable, required
    - `acs_median_rent` number, nullable, required
    - `acs_median_year_built` number, nullable, required
    - `acs_bachelors_plus_pct` number, nullable, required
    - `acs_owner_occupied_pct` number, nullable, required
    - `acs_poverty_pct` number, nullable, required
    - `acs_vacant_housing_pct` number, nullable, required
    - `acs_age_65plus_pct` number, nullable, required
    - `acs_broadband_pct` number, nullable, required
    - `acs_mean_commute_minutes` number, nullable, required
    - `acs_long_commute_pct` number, nullable, required
    - `tract_population` string, nullable, required
    - `tract_median_home_value` string, nullable, required
    - `tract_median_rent` string, nullable, required
    - `tract_owner_occupied_pct` string, nullable, required
    - `tract_vacancy_rate` string, nullable, required
    - `tract_poverty_rate` string, nullable, required
    - `tract_college_educated_pct` string, nullable, required
    - `tract_avg_income` string, nullable, required
    - `demographics_basis` string, required
    - `demographics_basis_withheld` string[], required
    - `demographics_basis_grain` object, required
      - `acs_median_hh_income` string, nullable, required
      - `acs_median_home_value` string, nullable, required
      - `acs_median_rent` string, nullable, required
      - `acs_median_year_built` string, nullable, required
      - `acs_bachelors_plus_pct` string, nullable, required
      - `acs_owner_occupied_pct` string, nullable, required
      - `acs_poverty_pct` string, nullable, required
      - `acs_vacant_housing_pct` string, nullable, required
      - `acs_age_65plus_pct` string, nullable, required
      - `acs_broadband_pct` string, nullable, required
      - `acs_mean_commute_minutes` string, nullable, required
      - `acs_long_commute_pct` string, nullable, required
      - `tract_population` string, nullable, required
      - `tract_median_home_value` string, nullable, required
      - `tract_median_rent` string, nullable, required
      - `tract_owner_occupied_pct` string, nullable, required
      - `tract_vacancy_rate` string, nullable, required
      - `tract_poverty_rate` string, nullable, required
      - `tract_college_educated_pct` string, nullable, required
      - `tract_avg_income` string, nullable, required
  - `economy` object, required
    - `bea_gdp_2024_thousands` number, nullable, required
    - `bea_gdp_2023_thousands` number, nullable, required
    - `bea_gdp_5y_growth_pct` number, nullable, required
    - `bea_gdp_10y_growth_pct` number, nullable, required
    - `bea_gdp_20y_growth_pct` number, nullable, required
    - `bea_pcpi_2024` number, nullable, required
    - `bea_pcpi_5y_growth_pct` number, nullable, required
    - `bea_personal_income_thousands_2024` number, nullable, required
    - `bea_population_2024` number, nullable, required
    - `county_employment` number, nullable, required
    - `county_unemployment_rate` number, nullable, required
    - `county_total_employees` number, nullable, required
    - `county_total_establishments` number, nullable, required
    - `county_median_income_irs` integer, nullable, required
    - `county_affordability_ratio` number, nullable, required
    - `county_affordability_rating` string, nullable, required
    - `lodes_jobs_total` number, nullable, required
    - `lodes_jobs_high_wage` number, nullable, required
    - `lodes_jobs_mid_wage` number, nullable, required
    - `lodes_jobs_low_wage` number, nullable, required
    - `lodes_jobs_healthcare` number, nullable, required
    - `lodes_jobs_manufacturing` number, nullable, required
    - `lodes_jobs_retail` number, nullable, required
    - `lodes_jobs_education` number, nullable, required
    - `lodes_jobs_hospitality` number, nullable, required
    - `tract_total_jobs` string, nullable, required
    - `tract_jobs_density_per_sqmi` string, nullable, required
    - `tract_high_wage_pct` string, nullable, required
    - `tract_healthcare_jobs_pct` string, nullable, required
    - `economy_basis` string, required
    - `economy_basis_withheld` string[], required
    - `economy_basis_grain` object, required
      - `county_employment` string, nullable, required
      - `county_unemployment_rate` string, nullable, required
      - `county_total_employees` string, nullable, required
      - `county_total_establishments` string, nullable, required
      - `lodes_jobs_total` string, nullable, required
      - `lodes_jobs_high_wage` string, nullable, required
      - `lodes_jobs_mid_wage` string, nullable, required
      - `lodes_jobs_low_wage` string, nullable, required
      - `lodes_jobs_healthcare` string, nullable, required
      - `lodes_jobs_manufacturing` string, nullable, required
      - `lodes_jobs_retail` string, nullable, required
      - `lodes_jobs_education` string, nullable, required
      - `lodes_jobs_hospitality` string, nullable, required
      - `tract_total_jobs` string, nullable, required
      - `tract_jobs_density_per_sqmi` string, nullable, required
      - `tract_high_wage_pct` string, nullable, required
      - `tract_healthcare_jobs_pct` string, nullable, required
  - `housing` object, required
    - `bps_total_units_2024` number, nullable, required
    - `bps_total_units_2023` number, nullable, required
    - `bps_total_value_2024` number, nullable, required
    - `bps_sf_units_2024` number, nullable, required
    - `bps_sf_value_2024` number, nullable, required
    - `bps_mf_units_2024` number, nullable, required
    - `bps_mf_value_2024` number, nullable, required
    - `bps_yoy_unit_growth_pct` number, nullable, required
    - `fhfa_hpi_latest` number, nullable, required
    - `fhfa_hpi_year` integer, nullable, required
    - `fhfa_hpi_1y_change_pct` number, nullable, required
    - `fhfa_hpi_5y_change_pct` number, nullable, required
    - `fhfa_hpi_10y_change_pct` number, nullable, required
    - `fhfa_hpi_20y_change_pct` number, nullable, required
    - `housing_basis` string, required
    - `housing_basis_withheld` string[], required
    - `housing_basis_grain` object, required
      - `fhfa_hpi_latest` string, nullable, required
      - `fhfa_hpi_year` string, nullable, required
      - `fhfa_hpi_1y_change_pct` string, nullable, required
      - `fhfa_hpi_5y_change_pct` string, nullable, required
      - `fhfa_hpi_10y_change_pct` string, nullable, required
      - `fhfa_hpi_20y_change_pct` string, nullable, required
  - `lending` object, required
    - `hmda_orig_count` number, nullable, required
    - `hmda_orig_volume_thousands` number, nullable, required
    - `hmda_avg_loan_amount_thousands` number, nullable, required
    - `hmda_avg_interest_rate` number, nullable, required
    - `hmda_avg_ltv` number, nullable, required
    - `hmda_conv_count` number, nullable, required
    - `hmda_fha_count` number, nullable, required
    - `hmda_va_count` number, nullable, required
    - `hmda_usda_count` number, nullable, required
    - `tract_loan_originations` string, nullable, required
    - `tract_avg_loan_amount` string, nullable, required
    - `tract_avg_interest_rate` string, nullable, required
    - `tract_fha_pct` string, nullable, required
    - `tract_investor_pct` string, nullable, required
    - `tract_credit_risk_tier` string, nullable, required
    - `tract_flood_claims` string, nullable, required
    - `tract_flood_loss_ratio` string, nullable, required
    - `lending_basis` string, required
    - `lending_basis_withheld` string[], required
    - `lending_basis_grain` object, required
      - `hmda_orig_count` string, nullable, required
      - `hmda_orig_volume_thousands` string, nullable, required
      - `hmda_avg_loan_amount_thousands` string, nullable, required
      - `hmda_avg_interest_rate` string, nullable, required
      - `hmda_avg_ltv` string, nullable, required
      - `hmda_conv_count` string, nullable, required
      - `hmda_fha_count` string, nullable, required
      - `hmda_va_count` string, nullable, required
      - `hmda_usda_count` string, nullable, required
      - `tract_loan_originations` string, nullable, required
      - `tract_avg_loan_amount` string, nullable, required
      - `tract_avg_interest_rate` string, nullable, required
      - `tract_fha_pct` string, nullable, required
      - `tract_investor_pct` string, nullable, required
      - `tract_credit_risk_tier` string, nullable, required
      - `tract_flood_claims` string, nullable, required
      - `tract_flood_loss_ratio` string, nullable, required
  - `hazard` object, required
    - `fema_disaster_count` integer, nullable, required
    - `fema_disaster_count_10y` integer, nullable, required
    - `fema_flood_count` integer, nullable, required
    - `fema_fire_count` integer, nullable, required
    - `fema_hurricane_count` integer, nullable, required
    - `fema_tornado_count` integer, nullable, required
    - `fema_earthquake_count` integer, nullable, required
    - `fema_sev_storm_count` integer, nullable, required
    - `fema_biological_count` integer, nullable, required
    - `fema_ia_declarations` number, nullable, required
    - `fema_pa_declarations` number, nullable, required
    - `fema_policy_count` number, nullable, required
    - `fema_top_incident_type` string, nullable, required
    - `fema_latest_declaration_date` string, nullable, required
    - `county_violent_crime_rate` number, nullable, required
    - `county_property_crime_rate` number, nullable, required
    - `hazard_basis` string, required
    - `hazard_basis_withheld` string[], required
    - `hazard_basis_grain` object, required
      - `fema_policy_count` string, nullable, required
      - `county_violent_crime_rate` string, nullable, required
      - `county_property_crime_rate` string, nullable, required
  - `healthcare` object, required
    - `cms_hosp_count` number, nullable, required
    - `cms_hosp_avg_stars` number, nullable, required
    - `cms_hosp_4_5_star` number, nullable, required
    - `cms_hosp_with_er` number, nullable, required
    - `cms_nh_count` number, nullable, required
    - `cms_nh_beds` number, nullable, required
    - `cms_nh_avg_stars` number, nullable, required
    - `cms_nh_4_5_star` number, nullable, required
    - `cms_nh_1_2_star` number, nullable, required
    - `cms_hospice_count` number, nullable, required
    - `cms_hh_count` number, nullable, required
    - `healthcare_basis` string, required
    - `healthcare_basis_withheld` string[], required
    - `healthcare_basis_grain` object, required
      - `cms_hosp_count` string, nullable, required
      - `cms_hosp_avg_stars` string, nullable, required
      - `cms_hosp_4_5_star` string, nullable, required
      - `cms_hosp_with_er` string, nullable, required
      - `cms_nh_count` string, nullable, required
      - `cms_nh_beds` string, nullable, required
      - `cms_nh_avg_stars` string, nullable, required
      - `cms_nh_4_5_star` string, nullable, required
      - `cms_nh_1_2_star` string, nullable, required
      - `cms_hospice_count` string, nullable, required
      - `cms_hh_count` string, nullable, required
  - `market` object, nullable, required
  - `market_history` unknown[], required
    - unknown
  - `market_provenance` 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
  - `generated_at` string, nullable, required
  - `_guards` string[], required

## Other responses

- `400`: A query or body parameter is invalid. Nothing was read or charged.
- `401`: Missing, malformed or invalid credential.
- `402`: Monthly call cap reached (free tier, or a paid tier with the hard cap enabled).
- `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)