---
title: "Net international migration - the number of people who moved into a geography from abroad minus the number who left for"
method: GET
path: "/api/v1/census/net_international_migration"
tags: ["census"]
---

# Net international migration - the number of people who moved into a geography from abroad minus the number who left for

`GET /api/v1/census/net_international_migration`

## Request

- Base URL: `https://georgiacivicdata.org`
- URL: `https://georgiacivicdata.org/api/v1/census/net_international_migration`
- Auth: none declared

Net international migration - the number of people who moved into a geography from abroad minus the number who left for abroad - as modeled by the U.S. Census Bureau's Population Estimates Program (PEP), Vintage 2025, for Georgia and each of its 159 counties, estimate years 2021-2025 (each covering July 1 of the prior year through June 30). Served as a signed count (negative = net out-migration), the average July 1 population the rate divides by, and the published rate per 1,000 residents (the headline metric). The component covers non-U.S.-born migration, U.S.-born movement to and from abroad, moves to and from Puerto Rico, and Armed Forces movement.

**Filterable categorical columns:** none

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

**Year coverage:** 2021–2025 (5 years, no gaps)

**NULL handling:** zero is a real value.

**Source:** U.S. Census Bureau, Population Estimates Program, Vintage 2025 county totals (CO-EST2025-ALLDATA)

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