Georgia Civic DataOccupation by Nativity (ACS)
What kinds of jobs Georgia's native-born, foreign-born, naturalized and noncitizen workers hold - the share of the civilian employed in each of five major occupation groups, for the state and its larger counties.
- 2020–2024
- annual
- 1.0.0
- 8e84efb0a9c5
Overview
Occupation of the civilian employed population 16 years and over by nativity and citizenship status, from the American Community Survey 5-year subject table S0501 (Selected Characteristics of the Native and Foreign-Born Populations - the civilian employed universe row and the five OCCUPATION rows only), for Georgia and the counties the Census publishes the table for (20-24 of 159 per vintage), vintages 2020-2024: the civilian employed count and the share working in each of the five major occupation groups (management/business/science/arts; service; sales and office; natural resources/construction/maintenance; production/transportation/material moving), for the total, native, foreign-born, naturalized-citizen and noncitizen populations, each with its 90 percent margin of error.
Row grain: One row per year, county_fips, district_code, tract_geoid, citizenship_status, occupation.
pct_of_civilian_employed — Share of Civilian Employed (proportion)
The single headline value most answers want.
Variables
Every column in the fact table. The code is the exact field name the API returns.
| Column | Type | Unit | Range | Null? | Description |
|---|---|---|---|---|---|
year | integer | — | — | no | ACS 5-year vintage END year: 2024 covers the pooled 2020-2024 survey period. Consecutive vintages overlap.Full description▾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; NULL on state rows. Only the 20-24 counties the Census publishes this table for appear in a vintage (see limitations).Full description▾5-digit county FIPS code (state 13 + county). Populated only on county-level rows; NULL on state rows. Only the 20-24 counties the Census publishes this table for appear in a vintage (see limitations). |
district_code | string | — | — | yes | Always NULL: the Census does not publish this subject table for most school districts and the district level was not collected. Kept for the census domain's standard key shape.Full description▾Always NULL: the Census does not publish this subject table for most school districts and the district level was not collected. Kept for the census domain's standard key shape. |
tract_geoid | string | — | — | yes | Always NULL: the Census publishes no census-tract estimates for this subject table. Kept for the census domain's standard key shape.Full description▾Always NULL: the Census publishes no census-tract estimates for this subject table. Kept for the census domain's standard key shape. |
citizenship_status | string | — | — | no | Native vs foreign born, and the foreign born by citizenship; a hierarchy, never summed.Full description▾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 universe is the civilian employed population 16 years and over (S0501 columns C01-C05). 5 allowed values▾
|
occupation | string | — | — | no | Major occupation group of the job held, or 'all' for the whole employed population.Full description▾Major occupation group (the standard five-group ACS scheme, unchanged across 2020-2024) of the job the person held in the reference week; the five groups partition the civilian employed population, and 'all' is the universe row. all: The whole civilian employed population 16+ (the universe row). management_business_science_arts: Management, business, science, and arts occupations. service: Service occupations. sales_office: Sales and office occupations. natural_resources_construction_maintenance: Natural resources, construction, and maintenance occupations. production_transportation_material_moving: Production, transportation, and material moving occupations. 6 allowed values▾
|
num_civilian_employed | integer | — | yes | Estimated civilian employed people 16+ in the citizenship category (the share's denominator).Full description▾ACS 5-year estimate of the civilian employed population 16 years and over in the citizenship_status category (S0501 row 056, the published universe count), repeated on every occupation row of the group as the denominator of pct_of_civilian_employed. Survey estimate, not a full count - see num_civilian_employed_moe. Do not multiply it by the shares to rebuild occupation counts: the shares are rounded to 0.1 pp. | |
num_civilian_employed_moe | integer | — | yes | 90 percent margin of error for num_civilian_employed, as published (integer persons). Never the headline metric.Full description▾90 percent margin of error for num_civilian_employed, as published (integer persons). Never the headline metric. | |
pct_of_civilian_employed | number | — | yes | Share of the group's civilian employed people working in the occupation group (0-1).Full description▾Share of the citizenship_status group's civilian employed population 16+ working in the occupation group, on the 0-1 scale: the published percent (S0501 rows 061-065, one decimal) divided by 100 and rounded to four decimals. The five occupation groups sum to 1 within 0.003. On the occupation 'all' row the value is 1.0 by construction (the universe row publishes no share). Served as published, never recomputed from counts; a value impossible on the scale would be NULLed and recorded (none in 2020-2024). | |
pct_of_civilian_employed_moe | number | — | yes | 90 percent margin of error for pct_of_civilian_employed, on the same 0-1 scale: the published percentage-point margin divided by 100 and rounded to four decimals. NULL on the occupation 'all' row. Never the headline metric.Full description▾90 percent margin of error for pct_of_civilian_employed, on the same 0-1 scale: the published percentage-point margin divided by 100 and rounded to four decimals. NULL on the occupation 'all' row. Never the headline metric. |
Filters
Query parameters the fact endpoint accepts. Comma-separated values are OR within a parameter; multiple parameters AND together.
| Parameter | Kind | Allowed values | Notes |
|---|---|---|---|
year | year_exact | any value | — |
year_min | year_range | any value | — |
year_max | year_range | any value | — |
detail | detail | countiesstates | enum-enforced, default: counties |
district_code | foreign_key | any value | multi-value |
county_fips | foreign_key | any value | multi-value |
tract_geoid | foreign_key | any value | multi-value |
citizenship_status | categorical | allnativeforeign_bornnaturalizednoncitizen | multi-value, enum-enforced |
occupation | categorical | allmanagement_business_science_artsservicesales_officenatural_resources_construction_maintenanceproduction_transportation_material_moving | multi-value, enum-enforced |
district_type | dimension_attribute | 7 allowed values▾
| multi-value, enum-enforced |
Example requests
Run these against the base URL — they return live data.
All rows (first page), counties level
curl "https://georgiacivicdata.org/api/v1/census/occupation_by_nativity"counties data for 2024
curl "https://georgiacivicdata.org/api/v1/census/occupation_by_nativity?year=2024"Filtered to citizenship_status = native for 2024
curl "https://georgiacivicdata.org/api/v1/census/occupation_by_nativity?year=2024&citizenship_status=native"One county (FIPS 13135), 2024
curl "https://georgiacivicdata.org/api/v1/census/occupation_by_nativity?county_fips=13135&year=2024&detail=counties"Download 2024 as CSV
curl "https://georgiacivicdata.org/api/v1/census/occupation_by_nativity?year=2024&format=csv"Notes & limitations
NULL handling
- Zero is a real, reported value.
Limitations
County coverage is PARTIAL: the Census publishes this subject table only where the foreign-born population is large enough, so just 20-24 of Georgia's 159 counties carry rows per vintage (22 in 2020, 20 in 2021, 23 in 2022, 24 in 2023 and 2024 - the larger metro Atlanta counties plus Chatham, Clarke, Columbia, Hall, Houston, Muscogee, Richmond, Whitfield and a few others). The other ~135 counties are absent, not zero, and the served set shifts slightly between vintages as counties cross the threshold; the state row is always present. citizenship_status is a hierarchy, not a partition: all = native + foreign_born and foreign_born = naturalized + noncitizen, so never sum across it. The ACS asks citizenship, not legal status: noncitizen covers lawful permanent residents, temporary visa holders, humanitarian migrants, and unauthorized migrants alike. Occupation shares are served as published (percents rounded to 0.1, converted to 0-1 proportions), so the five groups sum to 1 within 0.003 and must not be multiplied back into counts - reconstructed counts would carry false precision; num_civilian_employed is the published universe estimate. The occupation 'all' row is the universe row: its share is 1 by construction and it has no margin. 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 percent 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 percent margins of error (the *_moe columns, in the same units as their estimate); county margins on the naturalized and noncitizen columns run to several percentage points. Vintages 2020-2024 only. State and county geography only: district_code and tract_geoid are NULL on every row (the Census does not publish this table for census tracts or most school districts). No value is masked or suppressed in 2020-2024.