Skip to content

4.2 - Return Structure

{
     "StatusCode": 200,
     "Status": "ESUCC or EFAIL",
     "Message": "Request OK. ",
     "Debug": null,
     "Result": {}
}

Example

{
     "StatusCode": 200,
     "Status": "ESUCC",
     "Message": "Request OK. Request OK. {0}",
     "Debug": null,
     "Result": {
          "start_date": "2023-08-02",
          "end_date": "2023-11-09",
           "data": [
               {
                    "event_type": "Fiscal Balance",
                    "comparison": null,
                    "period": "Sep",
                    "country": "MX",
                    "date": "2023-10-27 20:15:00",
                    "actual": null,
                    "previous": -512.0,
                    "change": null,
                    "change_percentage": null
               },
               {
                    "event_type": "Baker Hughes Total Rig Count",
                    "comparison": null,
                    "period": "Oct/27",
                    "country": "US",
                    "date": "2023-10-27 17:50:00",
                    "actual": 625.0,
                    "previous": 624.0,
                    "change": 1.0,
                    "change_percentage": 0.16
               }
          ]
     }
}

On Failure

{
     "StatusCode": 401,
     "Status": "EFAIL",
     "Message": "Invalid Timestamp or Request too old.",
     "Debug": null,
     "Result": null
}

Note (checked against the API on 2026-11-11)

Today this operation is served at https://api.infotrie.com/api/idata/get_economic_events, with your InfoTrie API key in the X-API-Key header; the legacy AppKey header is refused with a 401. The same data, without the envelope, is at https://api.infotrie.com/api/market_data/get_economic_events.

On success the envelope is StatusCode 200, Status ESUCC, Message always Request OK. Request OK. {0}, Debug null, and Result the data. An error raised by the operation (a missing, unknown or malformed parameter: 400) comes in the same envelope, with Status EFAIL, Message Request Failed. followed by the reason, and Result null. A request refused before it reaches the operation (no or an invalid API key: 401; a key without the operation's scope: 403; over the rate limit: 429) gets {"status": "error", "message": "..."} instead of the envelope. There is no timestamp check: the 401 under On Failure is no longer sent.

Since the example was written, each event also carries estimate, the consensus published before the release (null when none was), and source, the public label of the source it is served from (the list of sources is open). date is the day of the event only (2023-10-27), without a time. comparison and period are an empty string, not null, when the event has none. Each release appears once per date, country, event type, comparison and period.

start_date is the start actually used: coverage begins on 2022-01-01, and a window reaching further back starts there. Events come in no set order.