GET /releases

Released schedule search

Allows searching for series' release schedule by a keyword and additional filtering criteria.

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,text/csv]
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,csv]
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
limit Number of records to return in the range 1 - 100. Default is 100. Number 100
offset The offset from which the records will be returned. Used to get the next set of records when the limit is reached. Number 0
database
Database filter. One or more comma separated database code values. Use /dictionary/databases to get an up to date list of available databases.
WORLD - *World Trend Plus*
WGEM - *Economic Monitor*
WAEM - *ASEAN Economic Monitor*
WFOR - *Forecast*
WCOM - *Commodity Market*
WCOC - *Country Competitiveness*
WAGR - *Aggregates*
WASS - *International Associations*
WIT10 - *Industry Top Companies*
GLOBAL - *Global Database*
AA - *Asia*
ECA - *Europe and Central Asia*
MEA - *Middle East and Africa*
NSA - *North and South America*
CEICGLBKS - *Global Key Series Database*
PMI - *IHS Markit Purchasing Managers' Index*
DAILY - *Daily Database*
BRAZIL - *Brazil Premium Database*
RUSSIA - *Russia Premium Database*
INDIA - *India Premium Database*
INDONESIA - *Indonesia Premium Database*
CN - *China Premium Database*
OXFORD - *Asia Forecasting Service*
OECD-MEI - *OECD - Main Economic Indicators*
OECD-EO - *OECD - Economic Outlook*
OECD-PROD - *OECD - Productivity*
OECD-NA - *OECD - National Accounts*
Accepted Values: [ WORLD,WGEM,WAEM,WFOR,WCOM,WCOC,WAGR,WASS,WIT10,GLOBAL,AA,ECA,MEA,NSA,CEICGLBKS,PMI,DAILY,BRAZIL,RUSSIA,INDIA,INDONESIA,CN,OXFORD,OECD-MEI,OECD-EO,OECD-PROD,OECD-NA]
Array
keyword Search term. One or more keywords. May contain special words further controlling the search results.
Keyword search tips:
Retail Sales - Show series with both keywords while the sequence of keywords is irrelevant. Equivalent to search Sales Retail
Retail AND Sales - Show results: series with terms of Retail AND Sales, regardless of the sequence. E. g. Retail Sales, Automobile Sales Retail
Retail;Sales - Show series with either keyword and series with both keywords while the sequence of keywords is irrelevant, equivalent to search: Sales;Retail
Retail OR Sales - Show results: series with terms of Retail OR Sales, regardless of the sequence. E. g. Retail Sales, Retail Trade, Sales Price, Motor Vehicle Sales
Retail NOT Sales - Narrow a search by excluding specific terms while the sequence of keywords is relevant. Show results: series with terms that include Retail, but NOT Sales. E. g. Retail Trade, Retail Price, Retail Bank
Retail Sales NOT (Hong Kong) - Narrow a search by excluding a set of words in parentheses while the sequence of keywords in parentheses is irrelevant, equivalent to search: Retail Sales NOT (Hong Kong). Show results: series with terms that include Retail Sales, but NOT Hong Kong, such as Retail Sales YoY: China, Retail Sales YoY: United States
String
frequency Frequency filter. One or more comma separated frequency code values.
D - Daily
W - Weekly
M - Monthly
Q - Quarterly
H - Semi-annual
Y - Annual
Z - Quinquennially
T - Decadal
Accepted Values: [ D,W,M,Q,H,Y,Z,T]
Array
source Source filter. One or more comma separated source code values. See related Dictionary function to get the full list of accepted sources. Array
unit Unit filter. One or more comma separated unit code values. See related Dictionary function to get the full list of accepted units. Array
indicator Indicator filter. One or more comma separated indicator code values. See related Dictionary function to get full list of accepted indicators. Array
region Region filter. One or more comma separated region code values. See related Dictionary function to get the full list of accepted regions. Array
subscribed_only Show only results for subscribed series when set to true. By default show results for all the series found. Boolean false
key_only Show only 'key' series when set to true. Boolean false
new_only Show only series created less than 1 month ago when set to true. Boolean false
name_only This filter related with the keyword filter. If it's true keyword search will be searched only in series name instead of all series attributes. Boolean false
start_date_before Will return series with first observation before start_date_before String
end_date_after Will return series with last observation after end_date_after String
created_after Will return entries created after created_after date String
updated_after Will return series last time updated after updated_after date String
geo Geo filter. One or more comma separated geo id values. See related Dictionary function to get the full list of accepted geo ids. Array
status Status filter. One or more comma separated status code values. When not explicitly set, defaults to T.
T - Active
C - Discontinued
B - Rebased
Accepted Values: [ T,C,B]
Array T
series List of series Array
topic Topic filter. One or more comma separated topic code values. Array
section Section filter. One or more comma separated section code values. Array
table Table filter. One or more comma separated table code values. Array
order Sort order. Default is relevance.
Accepted Values: [ relevance,popular,updated,new,percentage_change,last_value,status,country,frequency,first_date,last_date,unit,source]
Array
direction Sort order direction. Default is asc.
Accepted values:
asc - ascending
desc - descending
Accepted Values: [ asc,desc]
Array
filter_id Filter ID used to define a subset of data over which the search will be executed. When combined with additional search criterion, the result will be an intesection of both. Array
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
facet List of facets to return
Accepted Values: [ database,topic,section,table,region,country,geo,frequency,source,unit,status,indicator,additional]
Array
release_date_from Will return releases with first observation before release_date_from String
release_date_to Will return releases with last observation after release_date_to String
release_status List of release statuses to return
Accepted Values: [ Released,Pending,Delayed]
Array Released
offset The offset from which the records will be returned. Used to get the next set of records when the limit is reached. Number 0

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 Type Type
200 Search for detailed series' release schedule SeriesReleaseScheduleSearchResult
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, csv are supported. UnsupportedMedia
429 Too many requests were send or limit exceeded. TooManyRequests
500 Internal Server Error. InternalError
API Query Builder
Query
Query Result