Skip to content
← All datasets

Undocumented Immigrant Population Characteristics

The Center for Migration Studies' 2024 profile of Georgia's undocumented population by sex, age, birthplace and years in the U.S.

Year coverage
2024–2024
Updated
irregular
Version
1.0.0
Schema hash
8bef27a49d9f

Detail levels available

State · default

Overview

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.

Row grain: One row per year, county_fips, demographic, estimator, region_of_birth, country_of_birth, years_in_us, age_bracket.

Key metric

estimated_population — Estimated Undocumented Population (count)

The single headline value most answers want.

Variables

Every column in the fact table. The code is the exact field name the API returns.

ColumnTypeUnitRangeNull?Description
yearYearinteger——noCMS's data year as labeled by its State and National Data Tool (2024); the underlying ACS vintage is not stated. Not a federal fiscal year.
Full description
CMS's data year as labeled by its State and National Data Tool (2024); the underlying ACS vintage is not stated. Not a federal fiscal year.
county_fipsCounty FIPSstring——yesAlways NULL: CMS publishes states only. Kept for the immigration domain's shared key shape.
Full description
Always NULL: CMS publishes states only. Kept for the immigration domain's shared key shape.

Joins counties; adds its label columns.

demographicDemographicstring——noSex (female, male); 'all' = everyone.
Full description
Sex as the ACS records it: female or male; 'all' = total. A margin: never crossed with another breakdown, so on these rows every other breakdown column is 'all'.
3 allowed values
  • all
  • female
  • male

Joins demographics; adds its label columns.

estimatorEstimatorstring——noWho produced the estimate (cms).
Full description
The organization whose model produced the estimate: cms = Center for Migration Studies of New York, the only one of the four estimators in undocumented_population_estimates whose collected state file carries breakdowns. No 'all' total: estimators are never summed.
1 allowed value
  • cms
region_of_birthRegion of Birthstring——noCMS world region of birth; 'all' = everyone.
Full description
CMS's region of birth: africa, asia, caribbean, central_america, europe, north_america (Mexico and Canada), oceania, south_america; 'all' = total. Not the DHS OHSS or ACS regions. A margin: never crossed with another breakdown, so on these rows every other breakdown column is 'all'.
9 allowed values
  • all — total / aggregate
  • africa
  • asia
  • caribbean
  • central_america
  • europe
  • north_america
  • oceania
  • south_america
country_of_birthCountry of Birthstring——noCountry of birth (31 CMS-listed); 'all' = everyone.
Full description
Country of birth, for the 31 countries CMS lists (not exhaustive; no 'other'); 'all' = total. korea is CMS's unsplit 'Korea'. A margin: never crossed with another breakdown, so on these rows every other breakdown column is 'all'.
32 allowed values
  • all — total / aggregate
  • 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_usYears in USstring——noYears lived in the U.S.; 'all' = everyone.
Full description
Years since arrival in the United States: under_5, 5_9, 10_14, 15_19, 20_plus; 'all' = total. A margin: never crossed with another breakdown, so on these rows every other breakdown column is 'all'.
6 allowed values
  • all — total / aggregate
  • 10_14
  • 15_19
  • 20_plus
  • 5_9
  • under_5
age_bracketAge Bracketstring——noAge group; 'all' = everyone.
Full description
Age: under_5, 5_17, 18_20, 21_24, 25_34, 35_44, 45_64, 65_plus; 'all' = total. A margin: never crossed with another breakdown, so on these rows every other breakdown column is 'all'.
9 allowed values
  • all — total / aggregate
  • 18_20
  • 21_24
  • 25_34
  • 35_44
  • 45_64
  • 5_17
  • 65_plus
  • under_5
estimated_populationEstimated Undocumented Populationintegercount—yesCMS's modeled estimate of undocumented Georgia residents in the group.
Full description
CMS's estimate of the undocumented residents of Georgia in the row's group (every breakdown 'all' = the whole population), rounded to the nearest 1,000. A modeled stock, not a count.

Filters

Query parameters the fact endpoint accepts. Comma-separated values are OR within a parameter; multiple parameters AND together.

ParameterKindAllowed valuesNotes
yearyear_exactany value—
year_minyear_rangeany value—
year_maxyear_rangeany value—
detaildetailstatesenum-enforced, default: states
county_fipsforeign_keyany valuemulti-value
demographicforeign_keyallfemalemalemulti-value, enum-enforced
estimatorcategoricalcmsmulti-value, enum-enforced, pick one
region_of_birthcategorical
9 allowed values
  • all
  • africa
  • asia
  • caribbean
  • central_america
  • europe
  • north_america
  • oceania
  • south_america
multi-value, enum-enforced
country_of_birthcategorical
32 allowed values
  • 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
multi-value, enum-enforced
years_in_uscategoricalall10_1415_1920_plus5_9under_5multi-value, enum-enforced
age_bracketcategorical
9 allowed values
  • all
  • 18_20
  • 21_24
  • 25_34
  • 35_44
  • 45_64
  • 5_17
  • 65_plus
  • under_5
multi-value, enum-enforced
demographic_categorydimension_attribute
12 allowed values
  • aggregate
  • disability
  • economic_status
  • esol
  • foster_care
  • gender
  • grade
  • homeless_status
  • migrant_status
  • military
  • race
  • sped
multi-value, enum-enforced

Example requests

Run these against the base URL — they return live data.

All rows (first page), states level

curl "https://georgiacivicdata.org/api/v1/immigration/undocumented_population_characteristics"

states data for 2024

curl "https://georgiacivicdata.org/api/v1/immigration/undocumented_population_characteristics?year=2024"

Filtered to estimator = cms for 2024

curl "https://georgiacivicdata.org/api/v1/immigration/undocumented_population_characteristics?year=2024&estimator=cms"

Download 2024 as CSV

curl "https://georgiacivicdata.org/api/v1/immigration/undocumented_population_characteristics?year=2024&format=csv"

Notes & limitations

NULL handling

  • Suppressed cells (too few students to report) are NULL, never zero.
  • Zero is a real, reported value.

Limitations

A MODELED ESTIMATE, not a count of people: the Center for Migration Studies of New York (CMS) estimates the undocumented population from American Community Survey microdata (logical edits that remove likely legal residents, population controls by country, and an undercount adjustment; method: Robert Warren, Journal on Migration and Human Security, 2021). CMS labels the release data year 2024 and does not state the underlying ACS vintage. CMS publishes no margin of error; the figures are uncertain by an unquantified amount. The 'all' row (502,000) is the same CMS figure served as estimator = 'cms', year = 2024 in undocumented_population_estimates, which compares CMS with Pew, MPI and DHS. Of the four estimators' files collected here, only CMS's state file carries breakdowns, so this topic has CMS alone; MPI publishes state profiles with differently banded breakdowns on its website, which are not collected. For the size of Georgia's undocumented population, and how the estimators differ (340,000-502,000 for the latest years), use undocumented_population_estimates. BREAKDOWNS ARE NEVER CROSSED: CMS publishes each one separately (sex, age, region of birth, country of birth, years in the U.S.). A breakdown row carries 'all' in the other four columns, so filter one breakdown at a time, keep the rest at 'all', and never sum across two breakdowns (there is no 'women from Mexico' cell). Rounding: CMS rounds every cell to the nearest 1,000, so each value is within 500 of CMS's unrounded estimate, and a breakdown's parts need not add to the total: the age brackets sum to 501,000 against 502,000. On birthplace rows CMS also withholds values under 1,000 (below), and it does not say whether it applies that rule before or after rounding, so a published birthplace 1,000 means roughly 500-1,499 or 1,000-1,499. region_of_birth uses CMS's eight regions. CMS's north_america is Mexico and Canada, with central_america and caribbean as separate regions - unlike the DHS OHSS north_america in the naturalizations and new_permanent_residents topics (which includes Central America and the Caribbean) and the ACS regions in the census topics. country_of_birth lists the 31 countries CMS publishes, chosen by CMS nationally; it is NOT exhaustive: the listed countries sum to 472,000 of 502,000, and there is no 'other' row (a residual would carry up to +/-16,000 of rounding). 'korea' is CMS's unsplit 'Korea'; 'china' is CMS's 'China' (CMS does not say whether Hong Kong and Taiwan are included). CMS does not show a country or region with fewer than 1,000 undocumented residents in a state ('--' in its file, NULL here); no Georgia cell is withheld in the 2024 release. years_in_us is years since arrival in the United States at the data year: under_5 (184,000) matches CMS's own 'arrived 2020 onward' count. demographic carries sex (female, male) as the ACS records it; age_bracket follows CMS's eight age bands. Not included: CMS's race and Hispanic-origin breakdown (CMS does not say whether Pacific Islanders fall in 'Asian non-Hispanic' or 'Other non-Hispanic'); its liminal-status flags (DACA, TPS, parole, SIJS, U/T visa, pending asylum), whose categories overlap (Georgia's sum to 253,000 against 193,000 people with any liminal status) and so cannot be one breakdown; its period-of-entry table (an undefined smaller universe); its year-of-immigration table (the same information as years_in_us); and its socio-economic tables (marital status, English ability, language, school enrollment, education, computer access, health insurance, employment, occupation, poverty, family size, income). Georgia statewide only: CMS publishes states, not counties, and the other states and the national row are not included. Every value is CMS's published aggregate; this platform applies no suppression or adjustment. CMS's term is 'undocumented'.