Documentation

API URL


GET /api/v1/unemployment

Headers
Code
Content-Type: application/json
Query Parameters


Example GET Request

Code
GET https://datpaq.com/api/v1/unemployment?api_key=your-api-key&period=latest

Successful Response

Status
HTML
200 OK
Body
Code
{
  "success": true,
  "name": "National Unemployment Rate (Seasonally Adjusted)",
  "unit": "%",
  "adjusted": true,
  "period": "latest",
  "latest": {
    "date": "2026-06-01",
    "value": 4.1
  },
  "changes": null,
  "metadata": {
    "correlationId": "request-id",
    "api_token_name": null,
    "processingTime": "8ms",
    "timestamp": "2026-10-14T12:00:00.000Z",
    "rate_limit": null,
    "source": "FRED / BLS CPS",
    "seriesId": "UNRATE",
    "fromCache": false
  }
}

Error Response

Example
Code
HTTP 400 ValidationError: Missing or invalid route parameter — Request rejected by query validation; HTTP 401 Unauthorized: Missing or invalid API key — Gateway authentication rejects the request; HTTP 404 NotFound: Unknown route — Request does not match a defined endpoint; HTTP 429 RateLimited: Request count exceeds 200 per 15-minute window per IP — Rate limiter rejects the request; HTTP 500 InternalError: Metrics generation or shared middleware failure — Metrics route or middleware returns an internal error; HTTP 503 Unavailable: Missing provider access provider failure or metro infrastructure gate — Route returns unsuccessful result or explicit feature-gated response

Last Updated:  May 4, 2026