All APIs

Labour statistics API

Read official unemployment and labour-force participation data by country. Use REST or MCP to retrieve the latest accepted value, an exact period or dated history.

First request

Quickstart →
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/unemployment?period=2026-07" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
Example response Illustrative response · not a live request
{
  "country": "USA",
  "period": "2026-07",
  "rate": "4.1",
  "unit": "percent",
  "released_on": "2026-08-07"
}

Endpoints

GETUnemployment/v1/economics/{country}/unemployment

Retrieve the official unemployment rate for one observation period.

country
One supported uppercase country code; see this operation’s coverage list.
period
Omit it for the latest accepted complete release, or pass one exact period.

MCP · economics_get_unemployment

GETLabour-force participation/v1/economics/{country}/labour-force-participation

Retrieve the official labour-force participation rate for one observation period.

country
One supported uppercase country code; see this operation’s coverage list.
period
Omit it for the latest accepted complete release, or pass one exact period.

MCP · economics_get_labour_force_participation

Sources and methodology

Explicit periods

Omit it for the latest accepted complete release, or pass one exact period.

REST and MCP

Use one API key for current and historical data through REST or MCP.

Unemployment and labour-force participation are live today. Other labour measures shown in the grid are not currently live.

Indicators

Countries

Explore related pages

Economic data API

Official indicators for prices, labour, output, trade, and rates.

Explore the API →

Common questions

Which labour measures are live?

Unemployment rates and labour-force participation are live today.

Can I retrieve historical labour data?

Yes. Dated history and exact-period requests are available alongside the latest accepted value.

Do REST and MCP use the same API key?

Yes. The same API key works for REST and MCP.

Make your first request

Get a free API key →