GET /series/{id}

Returns full series data

Returns series containing both metadata and time-points data. Accepts one or more Series IDs or Series Codes.

Path Parameters

Name Description Type Required Default
id Series ID or Series Code to return. Accepts only one series ID or series Code. String

Header Parameters

Name Description Type Required Default
Accept-Language Preferred language code in which data shall be returned. Defaults to English if no translation in the specified language is available. Can be used through the query parameter query or using the header Accept-Language.

en - English
zh - Chinese
ru - Russian
id - Indonesian
jp - Japanese
Accepted Values: [ en,zh,ru,id,jp]
String en
Accept Response data format. Default is application/json. Can be used through the query parameter format or using the header Accept.
Accepted Values: [ application/json,application/xml]
String json

Query Parameters

Name Description Type Required Default
lang Preferred language code in which data will be returned. Defaults to English if no translation in the language specified is available. Can be used through the query parameter query or using the header Accept-Language.

en - English
zh - Chinese
ru - Russian
id - Indonesian
jp - Japanese
Accepted Values: [ en,zh,ru,id,jp]
String en
format Response data format. Default is json. Can be used through the query parameter format or using the header Accept.
Accepted Values: [ json,xml]
String json
token Access API key. String
with_model_information If set to true returns the model names as part of the response. Boolean false
vintage_revision_date When specified will return vintages snapshot at the specified revision date (YYYY-MM-DD). String
count Limit the amount of latest time-points returned, by the number specified. Integer 3650
start_date Limits the start date after which the time-points will be returned. String
end_date Limits the end date before which the time-points will be returned. String
updated_after Returns only the updated time-points after the date specified. String
blank_observations If it's set to true, empty time-points will be returned Boolean false
time_points_status Time points filter. One or more comma separated status code values. When not explicitly set, defaults to T.
T - Active
X - Deleted
Accepted Values: [ active,deleted]
String active
with_replacements_metadata If it is true result will contain replacements metadata not only list of ids Boolean false
forecast_only If it is true result will only contain series with forecast Boolean false
with_release_only If it is true result will only contain series with released schedule Boolean false
with_replacements_only If it is true result will only contain series with suggestions Boolean false
with_observations_only If it is true result will not contain series without observations Boolean false
with_continuous_only If set to true results will contain only series with available historical extensions Boolean false
with_historical_extension When set to true, series will include extended historical timepoints Boolean false

Responses

All API calls have response size limit of 10MB! If you are planning to request a bulky item collection, please consider using the corresponding API request parameters to limit your response.

Status Code Description Type
200 Series models containing both metadata and time-points data. SeriesResult
400 Incorrect input parameters. BadRequest
401 Authorization error. AuthorizationError
403 Incorrect user permissions. PermissionsError
404 Requested entity not found. NotFound
415 Unsupported data format. Only json, xml are supported. UnsupportedMedia
429 Too many requests were send or limit exceeded. TooManyRequests
500 Internal Server Error. InternalError
API Query Builder
Query
Query Result