All APIs

Unemployment API

Official unemployment rates with country-specific source coverage.

First request

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",
  "released_on": "2026-08-07"
}

Endpoints

GETUnemployment/v1/economics/{country}/unemployment

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.
version_id: Optional immutable publication version. Use `resource_version` from a `dataset.published` or `dataset.revised` event; omit to read the current admitted indicator.

MCP · economics_get_unemployment

API reference →

GETUnemployment history/v1/economics/{country}/unemployment/observations

country: One supported uppercase country code; see this operation’s coverage list.
start: Inclusive first observation period. On Free and Basic, a start before your plan window is moved to the first period inside it. The response then includes start.
end: Inclusive last observation period.
limit: Maximum number of periods returned. Defaults to 100. A page may contain fewer periods; follow next_cursor.
cursor: The next_cursor from the previous page.

MCP · economics_get_unemployment_history

API reference →

History

cURL

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/unemployment/observations?start=2026-07&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

Example response Illustrative response · not a live request

{
  "country": "USA",
  "as_of": "2026-08-12T00:00:00Z",
  "observations": [
    {
      "period": "2026-07",
      "rate": "4.1"
    }
  ],
  "next_cursor": null
}