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/jsonQuery Parameters
Param
Type
Description
id
required
string
Catalog indicator ID path parameter
limit
optional
number
Observations for series history 1-60 (default 12; BLS caps at 5)
Example GET Request
Code
GET https://datpaq.com/api/v1/economic-indicators/series/us_gdp_growth?limit=12&api_key=your-api-keySuccessful Response
Status
HTML
200 OKBody
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
}
}
}Field
Type
success
boolean
indicators
array
id
string
name
string
country
string
source
string
unit
string
observations
array
latest
object
rates
array
note
string
fromCache
boolean
updatedAt
string
metadata
object
metadata_correlationId
string
metadata_timestamp
string
metadata_processingTime
string
metadata_api_token_name
string
metadata_rate_limit
object
status
string
service
string
version
string
error
string
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 unavailableLast Updated: May 4, 2026