Documentation

API URL


GET /api/v1/economic-indicators/indicators, /api/v1/economic-indicators/series/:id, /api/v1/economic-indicators/series/:id/latest, /api/v1/economic-indicators/interest-rates

Headers
Code
Content-Type: application/json
Query Parameters


Example GET Request

Code
GET https://datpaq.com/api/v1/economic-indicators/series/us_gdp_growth?limit=12&api_key=your-api-key

Successful Response

Status
HTML
200 OK
Body
Code
{
  "success": true,
  "id": "us_gdp_growth",
  "name": "US GDP Growth",
  "country": "US",
  "source": "worldbank",
  "unit": "percent",
  "fromCache": false,
  "observations": [
    {
      "date": "2025-01-01",
      "value": 2.4
    }
  ],
  "updatedAt": "2026-10-13T12:00:00.000Z",
  "metadata": {
    "correlationId": "req_abc123",
    "timestamp": "2026-10-13T12:00:00.000Z",
    "processingTime": "18ms",
    "api_token_name": null,
    "rate_limit": {
      "limit": null,
      "remaining": null,
      "reset": null
    }
  }
}

Error Response

Example
Code
HTTP 400 ValidationError: Invalid limit or malformed indicator ID — Request rejected before upstream calls; HTTP 401 AuthenticationError: Gateway authentication failure — Request rejected due to missing or invalid API credentials; HTTP 404 UnknownIndicator: Indicator ID not in catalog — Series lookup target not available; HTTP 404 NotFound: Unknown endpoint path — Request path does not map to available economic-indicators routes; HTTP 429 RateLimitError: More than 200 requests in 15 minutes — Request rejected by service rate limiter; HTTP 503 UpstreamUnavailable: Upstream source failed or returned no observations — Series data temporarily unavailable

Last Updated:  May 4, 2026