---
title: "Migration (Moves In and Out)"
method: GET
path: "/migration"
tags: ["Local Economy"]
---

# Migration (Moves In and Out)

`GET /migration`

## Request

- Base URL: `https://api.dataporium.io`
- URL: `https://api.dataporium.io/migration`
- Auth: API key in query parameter `apikey`

Yearly household moves in and out of every US state and county, from official US government statistics based on where people filed their federal tax returns in two years in a row: movers in and out as returns (about one per household), people and income, net moves, net per 1,000 residents, moves from and to other countries, and the 10 largest origins and destinations.

The answer is {total, limit, offset, sort, order, as_of, rows, about}; as_of is the newest pair of years, e.g. 2022-2023.

## Query parameters

- `area_type` string
- `state` string
- `county` string
- `county_fips` string
- `area_code` string
- `year` integer
- `latest` boolean
- `include_top` boolean
- `sort` string
- `order` string
- `limit` integer
- `offset` integer

## Response `200`

Successful response (JSON).

- object

## Other responses

- `401`: No API key in the request.
- `403`: The API key is not valid or has expired.

---

[API](https://skmtc.dev/dataporium/apis/dataporium-data-api.md) · [All operations](https://skmtc.dev/dataporium/apis/dataporium-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dataporium/apis/dataporium-data-api/revisions/8bc593179dc8?raw)