---
title: "Labor Market (Snapshot)"
method: GET
path: "/macro/labor/snapshot"
tags: ["Macroeconomics"]
---

# Labor Market (Snapshot)

`GET /macro/labor/snapshot`

## Request

- Base URL: `https://api.financialdatasets.ai`
- URL: `https://api.financialdatasets.ai/macro/labor/snapshot`
- Auth: API key in header `X-API-KEY`

The most recent print of every labor market series (24 rows: monthly series on their latest month, weekly series on their latest week), or of one series when series is given, each with the change from the prior period and from a year earlier.

## Query parameters

- `series` string

## Response `200`

Labor market snapshot response

- LaborSnapshotResponse
  - `labor` LaborObservation[]
    - `series` string: The series id, e.g. payrolls_sa.
    - `date` string: The reference period in YYYY-MM-DD format: the first day of the month for monthly series (2026-08-01 for August 2026), the week-ending Saturday for weekly series. Not the release date.
    - `value` number, nullable: The published figure in the series' units (thousands of persons, percent, dollars per hour, persons). Null when the period was not published.
    - `change_prior` number, nullable: value minus the prior period's value (prior month or prior week), in the same units. Null when either period was not published.
    - `change_year` number, nullable: value minus the value one year earlier (the same month a year back, or the week 52 weeks back), in the same units. Null when either period was not published.
    - `change_year_pct` number, nullable: change_year as a percent of the year-earlier value, rounded to one decimal. Null when either period was not published, and always null for series measured in percent, whose change is stated in points in change_year.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `402`: The request requires a paid subscription
- `404`: The specified resource was not found

## Changes

- **2026-11-03** `5872e134b56c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/financialdatasets/apis/financial-datasets-api/changes/macro/labor/snapshot/get.md)

---

[API](https://skmtc.dev/financialdatasets/apis/financial-datasets-api.md) - [All operations](https://skmtc.dev/financialdatasets/apis/financial-datasets-api/llms.txt) - [OpenAPI document](https://skmtc.dev/financialdatasets/apis/financial-datasets-api/revisions/42ba45d24472?raw)