Introduction

Welcome to the IFR Events API documentation page. Here you will find information about published economic events, API endpoints, authentication and how to process the response returned by the API.

Events

The IFR Events API includes all published economic calendar events.

Subscriptions

Please contact your IFR account manager to discuss.

Endpoints

The Events API is composed of the following endpoints:

Authentication

Use this endpoint to request a token that will be sent with subsequent requests for stories.

The endpoint can either be used via the Swagger UI or programmatically.

  • Swagger UI - login using your credentials and copy the returned token into your client code for use in the authentication header.
  • Programmatically - call the endpoint once at the beginning of a session and use the token in subsequent requests.

Method POST
URL https://events-api.ifre.com/v1/auth
Input Username and Password
Request content type application/x-www-form-urlencoded
Response content type application/xml
Success An XML response with token and success message. Sample below 
                                
                                    <TokenResponse>
                                        <Token>XXXXXXXXXXXXXXX</Token>
                                        <Message>Success</Message>
                                    </TokenResponse>
Login failed 401 code and XML below 
                                
                                    <TokenResponse>
                                        <Message>Response status code does not indicate success: 401 (Unauthorized).</Message>
                                    </TokenResponse>
Other possible errors Code 500, if there is an issue with the server

Events Endpoint

Use this endpoint to request the latest published economic calendar events.

Method GET
URL https://events-api.ifre.com/v1/events
Parameters

Token

The authentication token from the authentication endpoint


Format

The format in which you wish to view the results. The default is json. Format: format=['json' or 'xml']


Fields

Specify which data elements to return. Format: fields=[comma separated list of fields]


Cat

Category or categories to return. See categories. Format(s): cat=N Or cat=N,N

Response content type application/json or application/xml as specified in the format paramater.
Success JSON or XML list of stories
Authorisation failed 403 code and JSON/ XML below 
                                
                                    {
                                        "service_info": [
                                          {
                                            "last_query_time": 1708605560,
                                            "message": "Invalid credentials supplied. (ERR: 4)"
                                          }
                                        ]
                                      }
                                

                                
                                    <body>
                                        <service_info>
                                            <last_query_time>1708605659</last_query_time>
                                            <message>Invalid credentials supplied. (ERR: 4)</message>
                                        </service_info>
                                    </body>
Other possible errors Code 500

Event Categories Endpoint

Use this endpoint to request the all the event categories.

Method GET
URL https://events-api.ifre.com/v1/events/categories
Parameters

Token

The authentication token from the authentication endpoint


Format

The format in which you wish to view the results. The default is json. Format: format=['json' or 'xml']


Response content type application/json or application/xml as specified in the format paramater.
Success JSON or XML list of stories
Authorisation failed 403 code and JSON/ XML below 
                                
                                    {
                                        "service_info": [
                                          {
                                            "last_query_time": 1708605560,
                                            "message": "Invalid credentials supplied. (ERR: 4)"
                                          }
                                        ]
                                      }
                                

                                
                                    <body>
                                        <service_info>
                                            <last_query_time>1708605659</last_query_time>
                                            <message>Invalid credentials supplied. (ERR: 4)</message>
                                        </service_info>
                                    </body>
Other possible errors Code 500

Swagger

Swagger UI can be found here.

Getting Help

For any queries regarding the Event API please contact https://myaccount.lseg.com/en/helpandsupport

For any queries regarding subscriptions please contact your LSEG account manager.

Changelog

See what's new added, changed, fixed, improved or updated in the latest versions.

Version 1.0 (20 February, 2024)

Initial Release