Foreign-Born Population (ACS)
How many residents of each Georgia community were born abroad, whether they have become citizens, and which world region they come from - ACS 5-year estimates down to the census tract.
- 2020–2024
- annual
- 1.1.0
- 4cbef1370749
Resumen
Population by nativity and citizenship from the American Community Survey 5-year estimates (detailed table B05002, Place of Birth by Nativity and Citizenship Status), for Georgia at state, county, school district, and census tract geography, vintages 2020-2024: the total population split native / foreign born, the foreign born by citizenship (naturalized U.S. citizen vs not a U.S. citizen) and by world region of birth, and the place-of-birth partition of the total (born in Georgia, another state, native born abroad, foreign born) with the other-state births by Census region and the native born abroad by Puerto Rico, U.S. Island Areas, or born abroad to American parents, each with its 90 percent margin of error.
Granularidad de fila: Una fila por year, county_fips, district_code, tract_geoid, citizenship_status, place_of_birth, region_of_birth, native_birthplace_detail.
population_count — Population Count (count)
El valor principal que la mayoría de las consultas busca.
Variables
Todas las columnas de la tabla de hechos. El código es el nombre exacto del campo que devuelve la API.
| Columna | Tipo | Unidad | Rango | ¿Nulo? | Descripción |
|---|---|---|---|---|---|
year | integer | — | — | no | ACS 5-year vintage END year: 2024 covers the pooled 2020-2024 survey period. Consecutive vintages overlap.Descripción completa▾ACS 5-year vintage END year: 2024 covers the pooled 2020-2024 survey period. Consecutive vintages overlap. |
county_fips | string | — | — | yes | 5-digit county FIPS code (state 13 + county). Populated only on county-level rows.Descripción completa▾5-digit county FIPS code (state 13 + county). Populated only on county-level rows. |
district_code | string | — | — | yes | GCD school district code (FK to the education districts dimension). Populated only on district-level rows - Census unified-school-district estimates mapped onto the ~180 standard districts via the dimension's district_census_id.Descripción completa▾GCD school district code (FK to the education districts dimension). Populated only on district-level rows - Census unified-school-district estimates mapped onto the ~180 standard districts via the dimension's district_census_id. |
tract_geoid | string | — | — | yes | 11-digit census tract GEOID (2020 boundaries). Populated only on tract-level rows.Descripción completa▾11-digit census tract GEOID (2020 boundaries). Populated only on tract-level rows. |
citizenship_status | string | — | — | no | Native vs foreign born, and the foreign born by citizenship; a hierarchy, never summed.Descripción completa▾Nativity and citizenship status. Hierarchical, not a partition: all = native + foreign_born, and foreign_born = naturalized + noncitizen, so the five values must never be summed. 'all' is the total row. The ACS asks citizenship, not legal status: noncitizen covers lawful permanent residents, temporary visa holders, and unauthorized migrants alike. In this topic the five values are served at place_of_birth = 'all' (region_of_birth = 'all' for the subtotals); the six region_of_birth breakdowns exist only under foreign_born, naturalized, and noncitizen. foreign_born here and place_of_birth = 'foreign_born' are the same people (B05002 cell 013). 5 valores permitidos▾
|
place_of_birth | string | — | — | no | Where residents were born: Georgia, another state, abroad as a citizen, or abroad as a foreign national.Descripción completa▾Place of birth. A partition of the total: all = born_in_state + born_other_state + native_born_abroad + foreign_born (the first three together are the native population). 'all' is the total row. 'Born in state' means born in Georgia, the state of residence. In this topic the four non-'all' values are served only at citizenship_status = 'all' and region_of_birth = 'all', where they partition the total; foreign_born here and citizenship_status = 'foreign_born' are the same people (B05002 cell 013). born_other_state and native_born_abroad each split further on native_birthplace_detail. 5 valores permitidos▾
|
region_of_birth | string | — | — | no | World region the foreign born were born in; pin citizenship_status to a foreign-born status to use it.Descripción completa▾World region of birth of the foreign-born population, per the Census B05002 grouping: europe, asia, africa, oceania, latin_america (Mexico, Central America, the Caribbean, South America), northern_america (Canada, Bermuda, Greenland, St. Pierre and Miquelon). 'all' is the status subtotal. Non-'all' values exist only under citizenship_status foreign_born, naturalized, and noncitizen at place_of_birth = 'all' - the source has no region cell for the native population, so no such row is published. The six regions sum to at most the subtotal: from vintage 2023 the noncitizen and foreign_born subtotals also include a few dozen people born at sea (one Cobb County tract) who belong to no region. 7 valores permitidos▾
|
native_birthplace_detail | string | — | — | no | Region of the other U.S. state of birth, or Puerto Rico / U.S. Island Areas / born abroad to American parents; pin place_of_birth to the parent to use it.Descripción completa▾Finer birthplace of the native population born outside Georgia, nested under place_of_birth (added in contract 1.1.0). Under place_of_birth = 'born_other_state', the Census region of the U.S. state of birth: other_state_northeast, other_state_midwest, other_state_south (the South region, Georgia itself excluded - it is born_in_state), other_state_west (B05002 cells 005-008). Under place_of_birth = 'native_born_abroad': puerto_rico, us_island_areas (American Samoa, Guam, the Northern Mariana Islands, the U.S. Virgin Islands), and born_abroad_of_american_parents (born in a foreign country to at least one U.S.-citizen parent) (cells 010-012). Each group partitions its place_of_birth parent exactly. 'all' is the parent total and the only value on every other row: values other than 'all' exist only at citizenship_status = 'all' and region_of_birth = 'all', under their own place_of_birth parent. 8 valores permitidos▾
|
population_count | integer | — | yes | Estimated residents in the nativity / citizenship / region-of-birth / native-birthplace-detail category.Descripción completa▾ACS 5-year estimate of the number of residents in the (citizenship_status, place_of_birth, region_of_birth, native_birthplace_detail) cell: the published B05002 cell (the seven native_birthplace_detail rows included), except that foreign_born x region rows are the exact sum of the naturalized and noncitizen region cells. Survey estimate, not a full count - see population_count_moe. | |
population_count_moe | number | — | yes | 90 percent margin of error for population_count. Published margins are served as-is (cast to float, never rounded); the six derived foreign_born x region rows carry the Census sqrt-sum-of-squares approximation over the two member-cell margins under the zero-estimate rule (non-integer). Never the headline metric.Descripción completa▾90 percent margin of error for population_count. Published margins are served as-is (cast to float, never rounded); the six derived foreign_born x region rows carry the Census sqrt-sum-of-squares approximation over the two member-cell margins under the zero-estimate rule (non-integer). Never the headline metric. |
Filtros
Parámetros de consulta que acepta el endpoint de filas del conjunto de datos (/rows), y también sus rutas /values, /aggregate y /download. Los valores separados por comas o repetidos son OR dentro de un parámetro; varios parámetros se combinan con AND.
| Parámetro | Tipo | Valores permitidos | Notas |
|---|---|---|---|
year | year_exact | cualquier valor | valores múltiples |
year_min | year_range | cualquier valor | — |
year_max | year_range | cualquier valor | — |
detail | detail | countiesdistrictsstatestracts | enum validado, predeterminado: counties |
district_code | foreign_key | cualquier valor | valores múltiples |
county_fips | foreign_key | cualquier valor | valores múltiples |
tract_geoid | foreign_key | cualquier valor | valores múltiples |
citizenship_status | categorical | allnativeforeign_bornnaturalizednoncitizen | valores múltiples, enum validado |
place_of_birth | categorical | allborn_in_stateborn_other_statenative_born_abroadforeign_born | valores múltiples, enum validado |
region_of_birth | categorical | 7 valores permitidos▾
| valores múltiples, enum validado |
native_birthplace_detail | categorical | 8 valores permitidos▾
| valores múltiples, enum validado |
district_type | dimension_attribute | 7 valores permitidos▾
| valores múltiples, enum validado |
population_count_min | metric_bound | cualquier valor | — |
population_count_max | metric_bound | cualquier valor | — |
population_count_moe_min | metric_bound | cualquier valor | — |
population_count_moe_max | metric_bound | cualquier valor | — |
Ejemplos de solicitudes
Ejecútalos contra la URL base: devuelven datos en vivo.
All rows (first page), counties level
curl "https://georgiacivicdata.org/api/v1/datasets/foreign_born_population/rows"counties data for 2024
curl "https://georgiacivicdata.org/api/v1/datasets/foreign_born_population/rows?year=2024"Filtered to citizenship_status = native for 2024
curl "https://georgiacivicdata.org/api/v1/datasets/foreign_born_population/rows?year=2024&citizenship_status=native"One district (code 667), 2024
curl "https://georgiacivicdata.org/api/v1/datasets/foreign_born_population/rows?district_code=667&year=2024&detail=districts"One county (FIPS 13135), 2024
curl "https://georgiacivicdata.org/api/v1/datasets/foreign_born_population/rows?county_fips=13135&year=2024&detail=counties"Download every 2024 row as CSV
curl "https://georgiacivicdata.org/api/v1/datasets/foreign_born_population/download?year=2024&format=csv"Notas y limitaciones
Manejo de NULL
- El cero es un valor real y reportado.
Limitaciones
citizenship_status is a hierarchy, not a partition: all = native + foreign_born and foreign_born = naturalized + noncitizen, so never sum across it. Each axis is a complete breakdown only with the others pinned to 'all': region_of_birth values other than 'all' exist only under citizenship_status foreign_born, naturalized, or noncitizen (the source has no native x region cell), and place_of_birth values other than 'all' exist only under citizenship_status 'all', where they partition the total (born_in_state + born_other_state + native_born_abroad + foreign_born). native_birthplace_detail values other than 'all' exist only under their place_of_birth parent, which they partition: the Census region of the other state of birth (other_state_northeast, other_state_midwest, other_state_south, other_state_west) under born_other_state, and puerto_rico, us_island_areas, and born_abroad_of_american_parents under native_born_abroad. The foreign_born value on the two axes is the same people (B05002 cell 013) served twice; do not add the axes together. foreign_born x region rows are derived as the exact sum of the naturalized and noncitizen region cells, with a Census sqrt-sum-of-squares margin (non-integer, served as a float). From vintage 2023 the noncitizen and foreign_born subtotals exceed the sum of their six region cells by the foreign-born population born at sea (32 people in 2023, 29 in 2024, all in Cobb County tract 302.45 and its county and school-district parents); the region rows therefore sum to at most, not exactly, the subtotal. The ACS asks citizenship, not legal status: noncitizen covers lawful permanent residents, temporary visa holders, humanitarian migrants, and unauthorized migrants alike. A NULL population_count_moe next to a present estimate is a controlled estimate (the total is fixed to official population totals, so no sampling error is published) - never suppression. ACS 5-year period estimates: the year column is the vintage END year and each estimate pools five years of survey responses (2024 = 2020-2024). Consecutive vintages share about 80% of their sample, so the series is heavily smoothed - never difference overlapping vintages as if they were annual change. Estimates are survey-based and carry 90% margins of error (the *_moe columns); tract-level margins can be large relative to the estimate. All levels serve vintages 2020-2024 only, on 2020-vintage tract boundaries. State rows have NULL county_fips, district_code, and tract_geoid; county rows carry only county_fips, district rows only district_code, tract rows only tract_geoid. District rows cover the ~180 standard (city/county) districts only: the Census publishes school-district estimates at unified school district geography, which has no codes for charter schools, RESAs, or state agencies, and its few Census-only districts (e.g. the Fort Stewart military district) have no GCD district code and are dropped.