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

# Labor Market (Historical)

`GET /macro/labor`

## Request

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

US labor market history for one series (the jobs report: nonfarm payrolls, unemployment rate, participation, hourly earnings; JOLTS job openings, hires, quits; weekly jobless claims), newest first, with the change from the prior period and from a year earlier. Dates are reference periods: the first day of the month for monthly series, the week-ending Saturday for weekly series. Values are in the series' units, sourced from authoritative government sources. A change is null when the comparison period was not published; change_year_pct is null for series measured in percent.

## Query parameters

- `series` string, required
- `start_date` string
- `end_date` string
- `cursor` string

## Response `200`

Labor market response

- LaborResponse
  - `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.
  - `next_page_url` string: Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.

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