---
title: "Number of people who obtained lawful permanent resident (LPR, green card) status while living in Georgia, by federal fis"
method: GET
path: "/api/v1/immigration/new_permanent_residents"
tags: ["immigration"]
---

# Number of people who obtained lawful permanent resident (LPR, green card) status while living in Georgia, by federal fis

`GET /api/v1/immigration/new_permanent_residents`

## Request

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

Number of people who obtained lawful permanent resident (LPR, green card) status while living in Georgia, by federal fiscal year, from the DHS Office of Homeland Security Statistics (OHSS). Statewide totals FY2015-FY2024 (Yearbook of Immigration Statistics 2024, Table 4) with separate country-of-birth and world-region-of-birth breakdowns for FY2024 (Supplemental Table 1); and, for the 4-7 Georgia counties among the 200 U.S. counties with the most new LPRs each year, FY2007-FY2024 counts by country of birth and major class of admission (OHSS Top 200 Counties tables). OHSS publishes no county all-country/all-class total; the key metric num_new_lprs_estimated carries a platform estimate there and OHSS's figures (its cells, exact sums of them, or 0 where it lists none) everywhere else; num_new_lprs is the same series without the estimates.

**Filterable categorical columns** (comma-separated values union; multiple columns AND together):
- `country_of_birth` — one of: `all`, `afghanistan`, `bangladesh`, `brazil`, `burma`, `china`, `colombia`, `cuba`, `dominican_republic`, `el_salvador`, `ethiopia`, `ghana`, `guatemala`, `haiti`, `honduras`, `india`, `iran`, `jamaica`, `kenya`, `mexico`, `nigeria`, `pakistan`, `philippines`, `south_korea`, `united_kingdom`, `venezuela`, `vietnam`, `other`, `unknown`
- `region_of_birth` — one of: `all`, `africa`, `asia`, `europe`, `north_america`, `oceania`, `south_america`, `unknown`
- `class_of_admission` — one of: `all`, `immediate_relative_spouse`, `immediate_relative_parent`, `immediate_relative_child`, `family_preference_1st`, `family_preference_2nd`, `family_preference_3rd`, `family_preference_4th`, `employment_preference_1st`, `employment_preference_2nd`, `employment_preference_3rd_skilled`, `employment_preference_3rd_unskilled`, `employment_preference_4th`, `employment_preference_5th`, `diversity`, `refugee_asylee_adjustment`, `other`

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

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

**NULL handling:** suppressed cells are NULL (not zero); zero is a real value through 2022 (later zeros may be suppressed cells).

**Source:** DHS Office of Homeland Security Statistics (OHSS) - New LPRs by State, County, Country of Birth, and Major Class of Admission (Top 200 Counties); Yearbook of Immigration Statistics 2024. County all-country/all-class totals estimated by Georgia Civic Data

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