---
title: "Modeled estimates of the undocumented (unauthorized) immigrant population living in Georgia from four independent estima"
method: GET
path: "/api/v1/immigration/undocumented_population_estimates"
tags: ["immigration"]
---

# Modeled estimates of the undocumented (unauthorized) immigrant population living in Georgia from four independent estima

`GET /api/v1/immigration/undocumented_population_estimates`

## Request

- Base URL: `https://georgiacivicdata.org`
- URL: `https://georgiacivicdata.org/api/v1/immigration/undocumented_population_estimates`
- Auth: none declared

Modeled estimates of the undocumented (unauthorized) immigrant population living in Georgia from four independent estimators - Pew Research Center (1990-2023, with a 90% margin of error), the Migration Policy Institute (mid-2023, statewide and ten counties), the Center for Migration Studies of New York (data year 2024) and the DHS Office of Homeland Security Statistics (January 1 of 2000 and 2005-2022 except 2021, revised series). One row per estimator and reference year; the estimator is always a filter, never summed.

**Filterable categorical columns** (comma-separated values union; multiple columns AND together):
- `estimator` — one of: `cms`, `dhs_ohss`, `mpi`, `pew`

**Detail levels available:** counties, states (default: `states`)

**Year coverage:** 1990–2024 (no data for: 1991, 1992, 1993, 1994, 1996, 1997, 1999, 2001, 2002, 2004)

**NULL handling:** zero is a real value.

**Source:** Pew Research Center; Migration Policy Institute; Center for Migration Studies of New York; DHS Office of Homeland Security Statistics

## Query parameters

- `year` integer, nullable: Exact year
- `year_min` integer, nullable: Inclusive lower bound
- `year_max` integer, nullable: Inclusive upper bound
- `district_code` string, nullable: Comma-separated list of GOSA district codes (e.g. `601,602`)
- `school_code` string, nullable: Comma-separated list of GOSA school codes. Combine with `district_code` for unique school keys.
- `county_fips` string, nullable: Comma-separated list of 5-digit county FIPS codes (e.g. `13121,13067`)
- `tract_geoid` string, nullable: Comma-separated list of 11-digit census tract GEOIDs (e.g. `13121011100`)
- `block_group_geoid` string, nullable: Comma-separated list of 12-digit census block group GEOIDs (e.g. `131210111001`)
- `demographic` string, nullable: Comma-separated demographic codes (e.g. `all,black,hispanic`)
- `detail` string, nullable: Detail level (whatever the topic publishes — e.g. schools, districts, counties, or states).
- `limit` integer, nullable: Page size
- `offset` integer: Page offset
- `columns` string, nullable: Comma-separated output columns to return (fact columns plus joined dimension attributes). Defaults to all.
- `format` 'json' | 'csv' | 'parquet': Response format: json | csv | parquet

## Response `200`

Paginated rows. JSON returns an envelope with `data` and `pagination`; CSV/Parquet return raw bytes with `X-Total-Count` header.

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/georgiacivicdata/apis/georgia-civic-data-api.md) · [All operations](https://skmtc.dev/georgiacivicdata/apis/georgia-civic-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/georgiacivicdata/apis/georgia-civic-data-api/revisions/dcfdf19662d2?raw)