---
title: "Characteristics of Georgia's undocumented immigrant population from the Center for Migration Studies of New York (CMS),"
method: GET
path: "/api/v1/immigration/undocumented_population_characteristics"
tags: ["immigration"]
---

# Characteristics of Georgia's undocumented immigrant population from the Center for Migration Studies of New York (CMS),

`GET /api/v1/immigration/undocumented_population_characteristics`

## Request

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

Characteristics of Georgia's undocumented immigrant population from the Center for Migration Studies of New York (CMS), data year 2024: CMS's modeled estimate of 502,000 broken down, one breakdown at a time, by sex, age bracket, world region of birth, country of birth (31 countries) and years in the United States. For the size of the population and how Pew, MPI, CMS and DHS compare, use undocumented_population_estimates.

**Filterable categorical columns** (comma-separated values union; multiple columns AND together):
- `estimator` — one of: `cms`
- `region_of_birth` — one of: `all`, `africa`, `asia`, `caribbean`, `central_america`, `europe`, `north_america`, `oceania`, `south_america`
- `country_of_birth` — one of: `all`, `afghanistan`, `argentina`, `bangladesh`, `brazil`, `canada`, `chile`, `china`, `colombia`, `dominican_republic`, `ecuador`, `el_salvador`, `ethiopia`, `ghana`, `guatemala`, `haiti`, `honduras`, `india`, `jamaica`, `korea`, `mexico`, `nepal`, `nicaragua`, `nigeria`, `pakistan`, `peru`, `philippines`, `poland`, `russia`, `ukraine`, `venezuela`, `vietnam`
- `years_in_us` — one of: `all`, `10_14`, `15_19`, `20_plus`, `5_9`, `under_5`
- `age_bracket` — one of: `all`, `18_20`, `21_24`, `25_34`, `35_44`, `45_64`, `5_17`, `65_plus`, `under_5`

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

**Year coverage:** 2024–2024 (1 years, no gaps)

**NULL handling:** suppressed cells are NULL (not zero); zero is a real value.

**Source:** Center for Migration Studies of New York, State and National Data Tool (undocumented population, data year 2024)

## 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)