API URL
GET /api/v1/gdp
Headers
Code
Content-Type: application/jsonQuery Parameters
Param
Type
Description
dataset
optional
string
Dataset selector: nominal real or deflator
datasets
optional
string
Comma-separated valid dataset keys for compare (max 100 chars; max 10 unique values)
source
optional
string
Data mode: auto snapshot or live
period
optional
string
History/compare window; latest and growth validate but ignore this control
points
optional
number
Growth trailing observation count (2-80; default 12)
startDate
optional
string
Inclusive valid calendar date lower bound (YYYY-MM-DD)
endDate
optional
string
Inclusive valid calendar date upper bound (YYYY-MM-DD)
Example GET Request
Code
GET https://datpaq.com/api/v1/gdp?api_key=your-api-key&dataset=nominal&source=snapshotSuccessful Response
Status
HTML
200 OKBody
Code
{
"success": true,
"source": "snapshot",
"requestedSource": "snapshot",
"resolvedSource": "snapshot",
"dataset": "nominal",
"name": "Nominal GDP",
"unit": "Billions of Dollars",
"seriesId": "GDP",
"latest": {
"date": "2026-06-01",
"value": 30834.1
},
"changes": null,
"snapshotAsOf": "2026-06-30",
"sourceCoverage": {
"firstObservationDate": "2026-06-01",
"lastObservationDate": "2026-06-01",
"observationCount": 1
},
"fallbackReason": null,
"metadata": {
"correlationId": "req-example-gdp",
"timestamp": "2026-10-12T12:00:00.000Z",
"processingTime": "3ms",
"api_token_name": null,
"rate_limit": {
"limit": null,
"remaining": null,
"reset": null
}
}
}Field
Type
success
boolean
source
string
requestedSource
string
resolvedSource
string
dataset
string
name
string
unit
string
seriesId
string
latest
object
latest_date
string
latest_value
number
data
array
data_date
string
data_value
number
changes
object
changes_qoq_percent
number
changes_qoq_annualized_percent
number
changes_yoy_percent
number
points
number
sourceCoverage
object
sourceCoverage_firstObservationDate
string
sourceCoverage_lastObservationDate
string
sourceCoverage_observationCount
number
snapshotAsOf
string
fallbackReason
string
datasets
array
datasets_id
string
datasets_name
string
datasets_seriesId
string
datasets_unit
string
datasets_description
string
period
string
startDate
string
endDate
string
rows
array
rows_dataset
string
rows_name
string
rows_unit
string
rows_latest
object
rows_changes
object
rows_seriesId
string
rows_source
string
rows_resolvedSource
string
rows_fallbackReason
string
periodOptions
array
sourceOptions
array
snapshotCoverage
object
snapshotCoverage_nominal
object
snapshotCoverage_real
object
snapshotCoverage_deflator
object
notes
object
notes_autoMode
string
notes_liveGate
string
notes_snapshotDepth
string
available
boolean
feature
string
reason
string
status
string
service
string
timestamp
string
version
string
fredConfigured
boolean
metadata
object
metadata_correlationId
string
metadata_timestamp
string
metadata_processingTime
string
metadata_api_token_name
string
metadata_rate_limit
object
Error Response
Example
Code
HTTP 400 ValidationError: Invalid dataset/source/period/points value, malformed calendar date, unsupported compare dataset, or startDate later than endDate — Request rejected by query validation; HTTP 401 AuthenticationError: Gateway rejects a missing or invalid API key — Request is unauthorized; HTTP 404 NotFound: No route matches the requested path — Endpoint not found response returned; HTTP 429 RateLimitError: More than 200 requests reach /api/* routes in 15 minutes — Request returns Too many requests; HTTP 502 UpstreamError: Explicit live mode fails or selected snapshot range has no observations — Result maps to Bad Gateway; HTTP 503 FeatureGateError: source=live requested without FRED_API_KEY — Response returns available false and gdp-live-data featureLast Updated: May 4, 2026