Economic Calendar by Country

This endpoint facilitates retrieving a filtered snapshot by countries from the economic calendar.

By country

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/calendar/country/united%20states?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

import tradingeconomics as te
te.login('your_api_key')
te.getCalendarData(country='united states')

With multi countries:

te.getCalendarData(country=['united states','china'])

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/country/united%20states?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

const te = require('tradingeconomics');
te.login('your_api_key');
data = te.getCalendar(country = 'united states').then(function(data){
    console.log(data)     
});

With multi countries:

data = te.getCalendar(country = ['united states', 'china']).then(function(data){
    console.log(data)     
});

Using Requests:

using (var httpClient = new HttpClient())
{
    using (var request = new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/country/united%20states?c=your_api_key"))
    {
        request.Headers.TryAddWithoutValidation("Upgrade-Insecure-Requests", "1");
        var response = await httpClient.SendAsync(request);
        if (response.IsSuccessStatusCode)
        {
            var content = await response.Content.ReadAsStringAsync(); 
            Console.WriteLine(content);
        }
    }
}

With multi countries:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/country/united%20states,china?c=your_api_key");

The response data format can be configured by appending the &f= parameter to the URL request.

/calendar/country/{country}

CalendarId	Date	Country	Category	Event	Reference	ReferenceDate	Source	SourceURL	Actual	Previous	Forecast	TEForecast	URL	Importance	LastUpdate	Revised	Currency	Unit	Ticker	Symbol
314956	1/5/2023 12:30:00 PM	United States	Challenger Job Cuts	Challenger Job Cuts	Dec	12/31/2022 12:00:00 AM	“Challenger, Gray and Christmas, Inc.”	https://www.challengergray.com	43.651K	76.835K		33K	/united-states/challenger-job-cuts	1	1/5/2023 12:30:00 PM			K	UNITEDSTACHAJOBCUT	UNITEDSTACHAJOBCUT
314792	1/5/2023 1:15:00 PM	United States	ADP Employment Change	ADP Employment Change	Dec	12/31/2022 12:00:00 AM	“Automatic Data Processing, Inc.”	https://adpemploymentreport.com/	235K	182K	150K	150K	/united-states/adp-employment-change	2	1/5/2023 1:31:54 PM	127K		K	UNITEDSTAADPEMPCHA	UNITEDSTAADPEMPCHA
314974	1/5/2023 1:30:00 PM	United States	Exports	Exports	Nov	11/30/2022 12:00:00 AM	U.S. Census Bureau	https://www.census.gov	$251.9B	$256.9B		$251.4B	/united-states/exports	2	1/5/2023 1:31:59 PM	$256.6B	$	B	TBEXTOT	TBEXTOT

/calendar/country/{country}?f=json

[
  {
    "CalendarId": "319275",
    "Date": "2023-04-03T13:45:00",
    "Country": "United States",
    "Category": "Manufacturing PMI",
    "Event": "S&P Global Manufacturing PMI Final",
    "Reference": "Mar",
    "ReferenceDate": "2023-03-31T00:00:00",
    "Source": "Markit Economics",
    "SourceURL": "https://www.markiteconomics.com",
    "Actual": "49.2",
    "Previous": "47.3",
    "Forecast": "49.3",
    "TEForecast": "49.3",
    "URL": "/united-states/manufacturing-pmi",
    "DateSpan": "0",
    "Importance": 2,
    "LastUpdate": "2023-04-03T13:45:00.493",
    "Revised": "",
    "Currency": "",
    "Unit": "",
    "Ticker": "UNITEDSTAMANPMI",
    "Symbol": "UNITEDSTAMANPMI"
  },
  {
    "CalendarId": "319279",
    "Date": "2023-04-03T14:00:00",
    "Country": "United States",
    "Category": "ISM Manufacturing Prices",
    "Event": "ISM Manufacturing Prices",
    "Reference": "Mar",
    "ReferenceDate": "2023-03-31T00:00:00",
    "Source": "Institute for Supply Management",
    "SourceURL": "https://www.ismworld.org",
    "Actual": "49.2",
    "Previous": "51.3",
    "Forecast": "51",
    "TEForecast": "51",
    "URL": "/united-states/ism-manufacturing-prices",
    "DateSpan": "0",
    "Importance": 1,
    "LastUpdate": "2023-04-03T14:00:00.567",
    "Revised": "",
    "Currency": "",
    "Unit": "",
    "Ticker": "USAIMP",
    "Symbol": "USAIMP"
  },
  {
    "CalendarId": "319280",
    "Date": "2023-04-03T14:00:00",
    "Country": "United States",
    "Category": "ISM Manufacturing Employment",
    "Event": "ISM Manufacturing Employment",
    "Reference": "Mar",
    "ReferenceDate": "2023-03-31T00:00:00",
    "Source": "Institute for Supply Management",
    "SourceURL": "https://www.ismworld.org",
    "Actual": "46.9",
    "Previous": "49.1",
    "Forecast": "",
    "TEForecast": "50",
    "URL": "/united-states/ism-manufacturing-employment",
    "DateSpan": "0",
    "Importance": 2,
    "LastUpdate": "2023-04-03T14:00:00.263",
    "Revised": "",
    "Currency": "",
    "Unit": "",
    "Ticker": "USAIME",
    "Symbol": "USAIME"
  }
]

/calendar/country/{country}?f=csv

CalendarId,Date,Country,Category,Event,Reference,ReferenceDate,Source,SourceURL,Actual,Previous,Forecast,TEForecast,URL,DateSpan,Importance,LastUpdate,Revised,Currency,Unit,Ticker,Symbol
319275,4/3/2023 1:45:00 PM,United States,Manufacturing PMI,S&P Global Manufacturing PMI Final,Mar,3/31/2023 12:00:00 AM,Markit Economics,https://www.markiteconomics.com,49.2,47.3,49.3,49.3,/united-states/manufacturing-pmi,0,2,4/3/2023 1:45:00 PM,,,,UNITEDSTAMANPMI,UNITEDSTAMANPMI
319279,4/3/2023 2:00:00 PM,United States,ISM Manufacturing Prices,ISM Manufacturing Prices,Mar,3/31/2023 12:00:00 AM,Institute for Supply Management,https://www.ismworld.org,49.2,51.3,51,51,/united-states/ism-manufacturing-prices,0,1,4/3/2023 2:00:00 PM,,,,USAIMP,USAIMP
319280,4/3/2023 2:00:00 PM,United States,ISM Manufacturing Employment,ISM Manufacturing Employment,Mar,3/31/2023 12:00:00 AM,Institute for Supply Management,https://www.ismworld.org,46.9,49.1,,50,/united-states/ism-manufacturing-employment,0,2,4/3/2023 2:00:00 PM,,,,USAIME,USAIME

/calendar/country/{country}?f=xml

<ArrayOfCalendarItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CalendarItem>
<CalendarId>319275</CalendarId>
<Date>2023-04-03T13:45:00</Date>
<Country>United States</Country>
<Category>Manufacturing PMI</Category>
<Event>S&P Global Manufacturing PMI Final</Event>
<Reference>Mar</Reference>
<ReferenceDate>2023-03-31T00:00:00</ReferenceDate>
<Source>Markit Economics</Source>
<SourceURL>https://www.markiteconomics.com</SourceURL>
<Actual>49.2</Actual>
<Previous>47.3</Previous>
<Forecast>49.3</Forecast>
<TEForecast>49.3</TEForecast>
<URL>/united-states/manufacturing-pmi</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2023-04-03T13:45:00.493</LastUpdate>
<Revised/>
<Currency/>
<Unit/>
<Ticker>UNITEDSTAMANPMI</Ticker>
<Symbol>UNITEDSTAMANPMI</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>319279</CalendarId>
<Date>2023-04-03T14:00:00</Date>
<Country>United States</Country>
<Category>ISM Manufacturing Prices</Category>
<Event>ISM Manufacturing Prices</Event>
<Reference>Mar</Reference>
<ReferenceDate>2023-03-31T00:00:00</ReferenceDate>
<Source>Institute for Supply Management</Source>
<SourceURL>https://www.ismworld.org</SourceURL>
<Actual>49.2</Actual>
<Previous>51.3</Previous>
<Forecast>51</Forecast>
<TEForecast>51</TEForecast>
<URL>/united-states/ism-manufacturing-prices</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2023-04-03T14:00:00.567</LastUpdate>
<Revised/>
<Currency/>
<Unit/>
<Ticker>USAIMP</Ticker>
<Symbol>USAIMP</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>319280</CalendarId>
<Date>2023-04-03T14:00:00</Date>
<Country>United States</Country>
<Category>ISM Manufacturing Employment</Category>
<Event>ISM Manufacturing Employment</Event>
<Reference>Mar</Reference>
<ReferenceDate>2023-03-31T00:00:00</ReferenceDate>
<Source>Institute for Supply Management</Source>
<SourceURL>https://www.ismworld.org</SourceURL>
<Actual>46.9</Actual>
<Previous>49.1</Previous>
<Forecast/>
<TEForecast>50</TEForecast>
<URL>/united-states/ism-manufacturing-employment</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2023-04-03T14:00:00.263</LastUpdate>
<Revised/>
<Currency/>
<Unit/>
<Ticker>USAIME</Ticker>
<Symbol>USAIME</Symbol>
</CalendarItem>
</ArrayOfCalendarItem>

By country and date

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/calendar/country/united%20states/2016-02-01/2016-02-10?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getCalendarData(country='united states', initDate='2016-02-01',
 endDate='2016-02-10')

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/country/united%20states/2016-02-01/2016-02-10?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getCalendar(country = 'united states', start_date = '2016-02-01',
 end_date = '2016-02-10').then(function(data){
    console.log(data)     
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/country/united%20states/2016-02-01/2016-02-10?c=guest:guest");

/calendar/country/{countries}/{yyyy-mm-dd}/{yyyy-mm-dd}

CalendarId	Date	Country	Category	Event	Reference	ReferenceDate	Source	SourceURL	Actual	Previous	Forecast	TEForecast	URL	Importance	LastUpdate	Revised	Unit	Ticker	Symbol
73494	2/1/2016 1:30:00 PM	United States	Personal Income	Personal Income (MoM)	Dec	12/31/2015 12:00:00 AM	U.S. Bureau of Economic Analysis	https://www.bea.gov	0.3%	0.3%	0.2%	0.2%	/united-states/personal-income	3	2/1/2016 1:30:00 PM		%	UNITEDSTAPERINC	UNITEDSTAPERINC
73495	2/1/2016 1:30:00 PM	United States	Personal Income	Personal Income (MoM)	Dec	12/31/2015 12:00:00 AM	U.S. Bureau of Economic Analysis	https://www.bea.gov	0.0%	0.5%	0.1%	0.2%	/united-states/personal-spending	3	2/1/2016 1:30:00 PM	0.3%	%	UNITEDSTAPERSPE	UNITEDSTAPERSPE
73496	2/1/2016 1:30:00 PM	United States	Core PCE Price Index MoM	Core PCE Price Index MoM	Dec	12/31/2015 12:00:00 AM	U.S. Bureau of Economic Analysis	https://www.bea.gov/	0.0%	0.2%	0.1%		/united-states/core-pce-price-index-mom	1	2/1/2016 1:39:00 PM	0.1%	%	USACPPIM	USACPPIM

/calendar/country/{countries}/{yyyy-mm-dd}/{yyyy-mm-dd}?f=json

[
  {
    "CalendarId": "73494",
    "Date": "2016-02-01T13:30:00",
    "Country": "United States",
    "Category": "Personal Income",
    "Event": "Personal Income (MoM)",
    "Reference": "Dec",
    "ReferenceDate": "2015-12-31T00:00:00",
    "Source": "U.S. Bureau of Economic Analysis",
    "SourceURL": "https://www.bea.gov",
    "Actual": "0.3%",
    "Previous": "0.3%",
    "Forecast": "0.2%",
    "TEForecast": "0.2%",
    "URL": "/united-states/personal-income",
    "DateSpan": "0",
    "Importance": 3,
    "LastUpdate": "2016-02-01T13:30:00",
    "Revised": "",
    "Currency": "",
    "Unit": "%",
    "Ticker": "UNITEDSTAPERINC",
    "Symbol": "UNITEDSTAPERINC"
  },
  {
    "CalendarId": "73495",
    "Date": "2016-02-01T13:30:00",
    "Country": "United States",
    "Category": "Personal Spending",
    "Event": "Personal Spending MoM",
    "Reference": "Dec",
    "ReferenceDate": "2015-12-31T00:00:00",
    "Source": "U.S. Bureau of Economic Analysis",
    "SourceURL": "https://www.bea.gov",
    "Actual": "0.0%",
    "Previous": "0.5%",
    "Forecast": "0.1%",
    "TEForecast": "0.2%",
    "URL": "/united-states/personal-spending",
    "DateSpan": "0",
    "Importance": 3,
    "LastUpdate": "2016-02-01T13:30:00",
    "Revised": "0.3%",
    "Currency": "",
    "Unit": "%",
    "Ticker": "UNITEDSTAPERSPE",
    "Symbol": "UNITEDSTAPERSPE"
  },
  {
    "CalendarId": "73496",
    "Date": "2016-02-01T13:30:00",
    "Country": "United States",
    "Category": "Core PCE Price Index MoM",
    "Event": "Core PCE Price Index MoM",
    "Reference": "Dec",
    "ReferenceDate": "2015-12-31T00:00:00",
    "Source": "U.S. Bureau of Economic Analysis",
    "SourceURL": "http://www.bea.gov/",
    "Actual": "0.0%",
    "Previous": "0.2%",
    "Forecast": "0.1%",
    "TEForecast": "",
    "URL": "/united-states/core-pce-price-index-mom",
    "DateSpan": "0",
    "Importance": 1,
    "LastUpdate": "2016-02-01T13:39:00",
    "Revised": "0.1%",
    "Currency": "",
    "Unit": "%",
    "Ticker": "USACPPIM",
    "Symbol": "USACPPIM"
  }
]

/calendar/country/{countries}/{yyyy-mm-dd}/{yyyy-mm-dd}?f=csv

CalendarId,Date,Country,Category,Event,Reference,ReferenceDate,Source,SourceURL,Actual,Previous,Forecast,TEForecast,URL,DateSpan,Importance,LastUpdate,Revised,Currency,Unit,Ticker,Symbol
73494,2/1/2016 1:30:00 PM,United States,Personal Income,Personal Income (MoM),Dec,12/31/2015 12:00:00 AM,U.S. Bureau of Economic Analysis,https://www.bea.gov,0.3%,0.3%,0.2%,0.2%,/united-states/personal-income,0,3,2/1/2016 1:30:00 PM,,,%,UNITEDSTAPERINC,UNITEDSTAPERINC
73495,2/1/2016 1:30:00 PM,United States,Personal Spending,Personal Spending MoM,Dec,12/31/2015 12:00:00 AM,U.S. Bureau of Economic Analysis,https://www.bea.gov,0.0%,0.5%,0.1%,0.2%,/united-states/personal-spending,0,3,2/1/2016 1:30:00 PM,0.3%,,%,UNITEDSTAPERSPE,UNITEDSTAPERSPE
73496,2/1/2016 1:30:00 PM,United States,Core PCE Price Index MoM,Core PCE Price Index MoM,Dec,12/31/2015 12:00:00 AM,U.S. Bureau of Economic Analysis,http://www.bea.gov/,0.0%,0.2%,0.1%,,/united-states/core-pce-price-index-mom,0,1,2/1/2016 1:39:00 PM,0.1%,,%,USACPPIM,USACPPIM

/calendar/country/{countries}/{yyyy-mm-dd}/{yyyy-mm-dd}?f=xml

<ArrayOfCalendarItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CalendarItem>
<CalendarId>73494</CalendarId>
<Date>2016-02-01T13:30:00</Date>
<Country>United States</Country>
<Category>Personal Income</Category>
<Event>Personal Income (MoM)</Event>
<Reference>Dec</Reference>
<ReferenceDate>2015-12-31T00:00:00</ReferenceDate>
<Source>U.S. Bureau of Economic Analysis</Source>
<SourceURL>https://www.bea.gov</SourceURL>
<Actual>0.3%</Actual>
<Previous>0.3%</Previous>
<Forecast>0.2%</Forecast>
<TEForecast>0.2%</TEForecast>
<URL>/united-states/personal-income</URL>
<DateSpan>0</DateSpan>
<Importance>3</Importance>
<LastUpdate>2016-02-01T13:30:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>UNITEDSTAPERINC</Ticker>
<Symbol>UNITEDSTAPERINC</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>73495</CalendarId>
<Date>2016-02-01T13:30:00</Date>
<Country>United States</Country>
<Category>Personal Spending</Category>
<Event>Personal Spending MoM</Event>
<Reference>Dec</Reference>
<ReferenceDate>2015-12-31T00:00:00</ReferenceDate>
<Source>U.S. Bureau of Economic Analysis</Source>
<SourceURL>https://www.bea.gov</SourceURL>
<Actual>0.0%</Actual>
<Previous>0.5%</Previous>
<Forecast>0.1%</Forecast>
<TEForecast>0.2%</TEForecast>
<URL>/united-states/personal-spending</URL>
<DateSpan>0</DateSpan>
<Importance>3</Importance>
<LastUpdate>2016-02-01T13:30:00</LastUpdate>
<Revised>0.3%</Revised>
<Currency/>
<Unit>%</Unit>
<Ticker>UNITEDSTAPERSPE</Ticker>
<Symbol>UNITEDSTAPERSPE</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>73496</CalendarId>
<Date>2016-02-01T13:30:00</Date>
<Country>United States</Country>
<Category>Core PCE Price Index MoM</Category>
<Event>Core PCE Price Index MoM</Event>
<Reference>Dec</Reference>
<ReferenceDate>2015-12-31T00:00:00</ReferenceDate>
<Source>U.S. Bureau of Economic Analysis</Source>
<SourceURL>http://www.bea.gov/</SourceURL>
<Actual>0.0%</Actual>
<Previous>0.2%</Previous>
<Forecast>0.1%</Forecast>
<TEForecast/>
<URL>/united-states/core-pce-price-index-mom</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2016-02-01T13:39:00</LastUpdate>
<Revised>0.1%</Revised>
<Currency/>
<Unit>%</Unit>
<Ticker>USACPPIM</Ticker>
<Symbol>USACPPIM</Symbol>
</CalendarItem>
</ArrayOfCalendarItem>

By country and importance

importance = (1-Low, 2-Medium, 3-High)

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/calendar/country/united%20states?c={api_key}&importance=3'
data = requests.get(url).json()
print(data)

Or using our package:

te.getCalendarData(country='united states', importance='3')

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/country/united%20states?c=${api_key}&importance=3`)
    console.log(response.data)
})()

Or using our package:

data = te.getCalendar(country = 'united states', importance='3').then(function(data){
    console.log(data)     
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/country/united%20states?c=guest:guest&importance=3");

/calendar/country/{countries}?importance={importance}

CalendarId	Date	Country	Category	Event	Reference	ReferenceDate	Source	SourceURL	Actual	Previous	Forecast	TEForecast	URL	Importance	LastUpdate	Revised	Unit	Ticker	Symbol
312678	1/6/2023 1:30:00 PM	United States	Non Farm Payrolls	Non Farm Payrolls	Dec	12/31/2022 12:00:00 AM	U.S. Bureau of Labor Statistics	https://www.bls.gov/	223K	256K	200K	220K	/united-states/non-farm-payrolls	3	1/6/2023 1:30:05 PM	263K	K	NFP TCH	NFP TCH
312679	1/6/2023 1:30:00 PM	United States	Unemployment Rate	Unemployment Rate	Dec	12/31/2022 12:00:00 AM	U.S. Bureau of Labor Statistics	https://www.bls.gov/	3.5%	3.6%	3.7%	3.7%	/united-states/unemployment-rate	3	1/6/2023 1:30:04 PM	3.7%	%	USURTOT	USURTOT
314984	1/6/2023 3:00:00 PM	United States	Non Manufacturing PMI	ISM Non-Manufacturing PMI	Dec	12/31/2022 12:00:00 AM	Institute for Supply Management	https://www.ismworld.org	49.6	56.5	55	53	/united-states/non-manufacturing-pmi	3	1/6/2023 3:00:00 PM			UNITEDSTANONMANPMI	UNITEDSTANONMANPMI

/calendar/country/{countries}?importance={importance}?f=json

[
  {
    "CalendarId": "319282",
    "Date": "2023-04-03T14:00:00",
    "Country": "United States",
    "Category": "Business Confidence",
    "Event": "ISM Manufacturing PMI",
    "Reference": "Mar",
    "ReferenceDate": "2023-03-31T00:00:00",
    "Source": "Institute for Supply Management",
    "SourceURL": "https://www.ismworld.org",
    "Actual": "46.3",
    "Previous": "47.7",
    "Forecast": "47.5",
    "TEForecast": "49",
    "URL": "/united-states/business-confidence",
    "DateSpan": "0",
    "Importance": 3,
    "LastUpdate": "2023-04-03T14:00:00.68",
    "Revised": "",
    "Currency": "",
    "Unit": "",
    "Ticker": "NAPMPMI",
    "Symbol": "NAPMPMI"
  },
  {
    "CalendarId": "318971",
    "Date": "2023-04-04T14:00:00",
    "Country": "United States",
    "Category": "Job Offers",
    "Event": "JOLTs Job Openings",
    "Reference": "Feb",
    "ReferenceDate": "2023-02-28T00:00:00",
    "Source": "U.S. Bureau of Labor Statistics",
    "SourceURL": "http://www.bls.gov",
    "Actual": "9.931M",
    "Previous": "10.563M",
    "Forecast": "10.4M",
    "TEForecast": "10.8M",
    "URL": "/united-states/job-offers",
    "DateSpan": "0",
    "Importance": 3,
    "LastUpdate": "2023-04-04T14:05:57.617",
    "Revised": "10.824M",
    "Currency": "",
    "Unit": "M",
    "Ticker": "UNITEDSTAJOBOFF",
    "Symbol": "UNITEDSTAJOBOFF"
  },
  {
    "CalendarId": "319436",
    "Date": "2023-04-05T12:30:00",
    "Country": "United States",
    "Category": "Balance of Trade",
    "Event": "Balance of Trade",
    "Reference": "Feb",
    "ReferenceDate": "2023-02-28T00:00:00",
    "Source": "Bureau of Economic Analysis (BEA)",
    "SourceURL": "https://www.bea.gov",
    "Actual": "$-70.5B",
    "Previous": "$-68.7B",
    "Forecast": "$-69B",
    "TEForecast": "$-69.0B",
    "URL": "/united-states/balance-of-trade",
    "DateSpan": "0",
    "Importance": 3,
    "LastUpdate": "2023-04-05T12:30:00.64",
    "Revised": "$-68.3B",
    "Currency": "$",
    "Unit": "B",
    "Ticker": "USTBTOT",
    "Symbol": "USTBTOT"
  }
]

/calendar/country/{countries}?importance={importance}?f=csv

CalendarId,Date,Country,Category,Event,Reference,ReferenceDate,Source,SourceURL,Actual,Previous,Forecast,TEForecast,URL,DateSpan,Importance,LastUpdate,Revised,Currency,Unit,Ticker,Symbol
319282,4/3/2023 2:00:00 PM,United States,Business Confidence,ISM Manufacturing PMI,Mar,3/31/2023 12:00:00 AM,Institute for Supply Management,https://www.ismworld.org,46.3,47.7,47.5,49,/united-states/business-confidence,0,3,4/3/2023 2:00:00 PM,,,,NAPMPMI,NAPMPMI
318971,4/4/2023 2:00:00 PM,United States,Job Offers,JOLTs Job Openings,Feb,2/28/2023 12:00:00 AM,U.S. Bureau of Labor Statistics,http://www.bls.gov,9.931M,10.563M,10.4M,10.8M,/united-states/job-offers,0,3,4/4/2023 2:05:57 PM,10.824M,,M,UNITEDSTAJOBOFF,UNITEDSTAJOBOFF
319436,4/5/2023 12:30:00 PM,United States,Balance of Trade,Balance of Trade,Feb,2/28/2023 12:00:00 AM,Bureau of Economic Analysis (BEA),https://www.bea.gov,$-70.5B,$-68.7B,$-69B,$-69.0B,/united-states/balance-of-trade,0,3,4/5/2023 12:30:00 PM,$-68.3B,$,B,USTBTOT,USTBTOT

/calendar/country/{countries}?importance={importance}?f=xml

<ArrayOfCalendarItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CalendarItem>
<CalendarId>319282</CalendarId>
<Date>2023-04-03T14:00:00</Date>
<Country>United States</Country>
<Category>Business Confidence</Category>
<Event>ISM Manufacturing PMI</Event>
<Reference>Mar</Reference>
<ReferenceDate>2023-03-31T00:00:00</ReferenceDate>
<Source>Institute for Supply Management</Source>
<SourceURL>https://www.ismworld.org</SourceURL>
<Actual>46.3</Actual>
<Previous>47.7</Previous>
<Forecast>47.5</Forecast>
<TEForecast>49</TEForecast>
<URL>/united-states/business-confidence</URL>
<DateSpan>0</DateSpan>
<Importance>3</Importance>
<LastUpdate>2023-04-03T14:00:00.68</LastUpdate>
<Revised/>
<Currency/>
<Unit/>
<Ticker>NAPMPMI</Ticker>
<Symbol>NAPMPMI</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>318971</CalendarId>
<Date>2023-04-04T14:00:00</Date>
<Country>United States</Country>
<Category>Job Offers</Category>
<Event>JOLTs Job Openings</Event>
<Reference>Feb</Reference>
<ReferenceDate>2023-02-28T00:00:00</ReferenceDate>
<Source>U.S. Bureau of Labor Statistics</Source>
<SourceURL>http://www.bls.gov</SourceURL>
<Actual>9.931M</Actual>
<Previous>10.563M</Previous>
<Forecast>10.4M</Forecast>
<TEForecast>10.8M</TEForecast>
<URL>/united-states/job-offers</URL>
<DateSpan>0</DateSpan>
<Importance>3</Importance>
<LastUpdate>2023-04-04T14:05:57.617</LastUpdate>
<Revised>10.824M</Revised>
<Currency/>
<Unit>M</Unit>
<Ticker>UNITEDSTAJOBOFF</Ticker>
<Symbol>UNITEDSTAJOBOFF</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>319436</CalendarId>
<Date>2023-04-05T12:30:00</Date>
<Country>United States</Country>
<Category>Balance of Trade</Category>
<Event>Balance of Trade</Event>
<Reference>Feb</Reference>
<ReferenceDate>2023-02-28T00:00:00</ReferenceDate>
<Source>Bureau of Economic Analysis (BEA)</Source>
<SourceURL>https://www.bea.gov</SourceURL>
<Actual>$-70.5B</Actual>
<Previous>$-68.7B</Previous>
<Forecast>$-69B</Forecast>
<TEForecast>$-69.0B</TEForecast>
<URL>/united-states/balance-of-trade</URL>
<DateSpan>0</DateSpan>
<Importance>3</Importance>
<LastUpdate>2023-04-05T12:30:00.64</LastUpdate>
<Revised>$-68.3B</Revised>
<Currency>$</Currency>
<Unit>B</Unit>
<Ticker>USTBTOT</Ticker>
<Symbol>USTBTOT</Symbol>
</CalendarItem>
</ArrayOfCalendarItem>

By country and indicator

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/calendar/country/united%20states/indicator/initial%20jobless%20claims?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getCalendarData(country='united states',
 category='initial jobless claims')

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/country/united%20states/indicator/initial%20jobless%20claims?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getCalendar(country = 'united states',
 indicator = 'initial jobless claims').then(function(data){
    console.log(data)     
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/country/united%20states/indicator/initial%20jobless%20claims?c=guest:guest");

/calendar/country/{countries}/indicator/{indicators}

CalendarId	Date	Country	Category	Event	Reference	ReferenceDate	Source	SourceURL	Actual	Previous	Forecast	TEForecast	URL	Importance	LastUpdate	Revised	Unit	Ticker	Symbol
312710	1/12/2023 1:30:00 PM	United States	Initial Jobless Claims	Initial Jobless Claims	Jan/07	1/7/2023 12:00:00 AM	U.S. Department of Labor	https://www.dol.gov	205K	206K	215K	215K	/united-states/jobless-claims	2	1/12/2023 1:30:33 PM	204K	K	IJCUSA	IJCUSA
312752	1/19/2023 1:30:00 PM	United States	Initial Jobless Claims	Initial Jobless Claims	Jan/14	1/14/2023 12:00:00 AM	U.S. Department of Labor	https://www.dol.gov	190K	205K	214K	207K	/united-states/jobless-claims	2	1/19/2023 1:30:17 PM		K	IJCUSA	IJCUSA
312784	1/26/2023 1:30:00 PM	United States	Initial Jobless Claims	Initial Jobless Claims	Jan/21	1/21/2023 12:00:00 AM	U.S. Department of Labor	https://www.dol.gov	186K	192K	205K	202K	/united-states/jobless-claims	2	1/26/2023 1:30:02 PM	190K	K	IJCUSA	IJCUSA

/calendar/country/{countries}/indicator/{indicators}?f=json

[
  {
    "CalendarId": "313158",
    "Date": "2023-04-06T12:30:00",
    "Country": "United States",
    "Category": "Initial Jobless Claims",
    "Event": "Initial Jobless Claims",
    "Reference": "Apr/01",
    "ReferenceDate": "2023-04-01T00:00:00",
    "Source": "U.S. Department of Labor",
    "SourceURL": "http://www.dol.gov",
    "Actual": "228K",
    "Previous": "246K",
    "Forecast": "200K",
    "TEForecast": "205.0K",
    "URL": "/united-states/jobless-claims",
    "DateSpan": "0",
    "Importance": 2,
    "LastUpdate": "2023-04-06T12:30:09.96",
    "Revised": "198K",
    "Currency": "",
    "Unit": "K",
    "Ticker": "IJCUSA",
    "Symbol": "IJCUSA"
  },
  {
    "CalendarId": "313203",
    "Date": "2023-04-13T12:30:00",
    "Country": "United States",
    "Category": "Initial Jobless Claims",
    "Event": "Initial Jobless Claims",
    "Reference": "Apr/08",
    "ReferenceDate": "2023-04-08T00:00:00",
    "Source": "U.S. Department of Labor",
    "SourceURL": "http://www.dol.gov",
    "Actual": "239K",
    "Previous": "228K",
    "Forecast": "232K",
    "TEForecast": "234.0K",
    "URL": "/united-states/jobless-claims",
    "DateSpan": "0",
    "Importance": 2,
    "LastUpdate": "2023-04-13T12:30:05.787",
    "Revised": "",
    "Currency": "",
    "Unit": "K",
    "Ticker": "IJCUSA",
    "Symbol": "IJCUSA"
  },
  {
    "CalendarId": "313240",
    "Date": "2023-04-20T12:30:00",
    "Country": "United States",
    "Category": "Initial Jobless Claims",
    "Event": "Initial Jobless Claims",
    "Reference": "Apr/15",
    "ReferenceDate": "2023-04-15T00:00:00",
    "Source": "U.S. Department of Labor",
    "SourceURL": "http://www.dol.gov",
    "Actual": "245K",
    "Previous": "240K",
    "Forecast": "240K",
    "TEForecast": "244.0K",
    "URL": "/united-states/jobless-claims",
    "DateSpan": "0",
    "Importance": 2,
    "LastUpdate": "2023-04-20T12:30:02.75",
    "Revised": "239K",
    "Currency": "",
    "Unit": "K",
    "Ticker": "IJCUSA",
    "Symbol": "IJCUSA"
  }
]

/calendar/country/{countries}/indicator/{indicators}?f=csv

CalendarId,Date,Country,Category,Event,Reference,ReferenceDate,Source,SourceURL,Actual,Previous,Forecast,TEForecast,URL,DateSpan,Importance,LastUpdate,Revised,Currency,Unit,Ticker,Symbol
313158,4/6/2023 12:30:00 PM,United States,Initial Jobless Claims,Initial Jobless Claims,Apr/01,4/1/2023 12:00:00 AM,U.S. Department of Labor,http://www.dol.gov,228K,246K,200K,205.0K,/united-states/jobless-claims,0,2,4/6/2023 12:30:09 PM,198K,,K,IJCUSA,IJCUSA
313203,4/13/2023 12:30:00 PM,United States,Initial Jobless Claims,Initial Jobless Claims,Apr/08,4/8/2023 12:00:00 AM,U.S. Department of Labor,http://www.dol.gov,239K,228K,232K,234.0K,/united-states/jobless-claims,0,2,4/13/2023 12:30:05 PM,,,K,IJCUSA,IJCUSA
313240,4/20/2023 12:30:00 PM,United States,Initial Jobless Claims,Initial Jobless Claims,Apr/15,4/15/2023 12:00:00 AM,U.S. Department of Labor,http://www.dol.gov,245K,240K,240K,244.0K,/united-states/jobless-claims,0,2,4/20/2023 12:30:02 PM,239K,,K,IJCUSA,IJCUSA

/calendar/country/{countries}/indicator/{indicators}?f=xml

<ArrayOfCalendarItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CalendarItem>
<CalendarId>313158</CalendarId>
<Date>2023-04-06T12:30:00</Date>
<Country>United States</Country>
<Category>Initial Jobless Claims</Category>
<Event>Initial Jobless Claims</Event>
<Reference>Apr/01</Reference>
<ReferenceDate>2023-04-01T00:00:00</ReferenceDate>
<Source>U.S. Department of Labor</Source>
<SourceURL>http://www.dol.gov</SourceURL>
<Actual>228K</Actual>
<Previous>246K</Previous>
<Forecast>200K</Forecast>
<TEForecast>205.0K</TEForecast>
<URL>/united-states/jobless-claims</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2023-04-06T12:30:09.96</LastUpdate>
<Revised>198K</Revised>
<Currency/>
<Unit>K</Unit>
<Ticker>IJCUSA</Ticker>
<Symbol>IJCUSA</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>313203</CalendarId>
<Date>2023-04-13T12:30:00</Date>
<Country>United States</Country>
<Category>Initial Jobless Claims</Category>
<Event>Initial Jobless Claims</Event>
<Reference>Apr/08</Reference>
<ReferenceDate>2023-04-08T00:00:00</ReferenceDate>
<Source>U.S. Department of Labor</Source>
<SourceURL>http://www.dol.gov</SourceURL>
<Actual>239K</Actual>
<Previous>228K</Previous>
<Forecast>232K</Forecast>
<TEForecast>234.0K</TEForecast>
<URL>/united-states/jobless-claims</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2023-04-13T12:30:05.787</LastUpdate>
<Revised/>
<Currency/>
<Unit>K</Unit>
<Ticker>IJCUSA</Ticker>
<Symbol>IJCUSA</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>313240</CalendarId>
<Date>2023-04-20T12:30:00</Date>
<Country>United States</Country>
<Category>Initial Jobless Claims</Category>
<Event>Initial Jobless Claims</Event>
<Reference>Apr/15</Reference>
<ReferenceDate>2023-04-15T00:00:00</ReferenceDate>
<Source>U.S. Department of Labor</Source>
<SourceURL>http://www.dol.gov</SourceURL>
<Actual>245K</Actual>
<Previous>240K</Previous>
<Forecast>240K</Forecast>
<TEForecast>244.0K</TEForecast>
<URL>/united-states/jobless-claims</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2023-04-20T12:30:02.75</LastUpdate>
<Revised>239K</Revised>
<Currency/>
<Unit>K</Unit>
<Ticker>IJCUSA</Ticker>
<Symbol>IJCUSA</Symbol>
</CalendarItem>
</ArrayOfCalendarItem>

By country and group

group = (interest rate, inflation, bonds, consumer, gdp, government, housing, labour, markets, money, prices, trade, business)

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/calendar/country/united%20states/group/bonds?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getCalendarEventsByGroup(country='united states', group='bonds')

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/country/united%20states/group/bonds?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getCalendarEventsByGroup(country = 'united states',
 group = 'bonds').then(function(data){
    console.log(data)     
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/country/united%20states/group/bonds?c=guest:guest");

/calendar/country/{country}/group/{group}

CalendarId	Date	Country	Category	Event	Source	SourceURL	Actual	Previous	URL	Importance	LastUpdate	Unit	Ticker	Symbol
312689	1/9/2023 4:30:00 PM	United States	3 Month Bill Yield	3-Month Bill Auction	Federal Reserve	https://www.treasurydirect.gov	4.56%	4.41%	/united-states/6-month-bill-yield	1	1/9/2023 4:32:00 PM	%	UNITEDSTA3MONBILYIE	UNITEDSTA3MONBILYIE
312690	1/9/2023 4:30:00 PM	United States	6 Month Bill Yield	6-Month Bill Auction	Federal Reserve	https://www.treasurydirect.gov	4.71%	4.635%	/united-states/3-month-bill-yield	1	1/9/2023 4:32:00 PM	%	UNITEDSTA6MONBILYIE	UNITEDSTA6MONBILYIE
312316	1/10/2023 6:00:00 PM	United States	3 Year Note Yield	3-Year Note Auction	Federal Reserve	https://www.treasurydirect.gov	3.977%	4.093%	/united-states/3-year-note-yield	1	1/10/2023 6:02:09 PM	%	UNITEDSTA3YEANOTYIE	UNITEDSTA3YEANOTYIE

/calendar/country/{country}/group/{group}?f=json

[
  {
    "CalendarId": "313137",
    "Date": "2023-04-03T15:30:00",
    "Country": "United States",
    "Category": "3 Month Bill Yield",
    "Event": "3-Month Bill Auction",
    "Reference": "",
    "ReferenceDate": null,
    "Source": "Federal Reserve",
    "SourceURL": "http://www.treasurydirect.gov",
    "Actual": "4.78%",
    "Previous": "4.675%",
    "Forecast": "",
    "TEForecast": "",
    "URL": "/united-states/3-month-bill-yield",
    "DateSpan": "0",
    "Importance": 1,
    "LastUpdate": "2023-04-03T15:32:15.98",
    "Revised": "",
    "Currency": "",
    "Unit": "%",
    "Ticker": "UNITEDSTA3MONBILYIE",
    "Symbol": "UNITEDSTA3MONBILYIE"
  },
  {
    "CalendarId": "313138",
    "Date": "2023-04-03T15:30:00",
    "Country": "United States",
    "Category": "6 Month Bill Yield",
    "Event": "6-Month Bill Auction",
    "Reference": "",
    "ReferenceDate": null,
    "Source": "Federal Reserve",
    "SourceURL": "http://www.treasurydirect.gov",
    "Actual": "4.705%",
    "Previous": "4.65%",
    "Forecast": "",
    "TEForecast": "",
    "URL": "/united-states/6-month-bill-yield",
    "DateSpan": "0",
    "Importance": 1,
    "LastUpdate": "2023-04-03T15:33:02.4",
    "Revised": "",
    "Currency": "",
    "Unit": "%",
    "Ticker": "UNITEDSTA6MONBILYIE",
    "Symbol": "UNITEDSTA6MONBILYIE"
  },
  {
    "CalendarId": "338272",
    "Date": "2023-04-05T15:30:00",
    "Country": "United States",
    "Category": "Calendar",
    "Event": "17-Week Bill Auction",
    "Reference": "",
    "ReferenceDate": null,
    "Source": "",
    "SourceURL": "",
    "Actual": "4.750%",
    "Previous": "4.780%",
    "Forecast": "",
    "TEForecast": "",
    "URL": "/united-states/calendar",
    "DateSpan": "0",
    "Importance": 1,
    "LastUpdate": "2023-04-05T15:34:42.987",
    "Revised": "",
    "Currency": "",
    "Unit": "%",
    "Ticker": "USD CALENDAR",
    "Symbol": ""
  }
]

/calendar/country/{country}/group/{group}?f=csv

CalendarId,Date,Country,Category,Event,Reference,ReferenceDate,Source,SourceURL,Actual,Previous,Forecast,TEForecast,URL,DateSpan,Importance,LastUpdate,Revised,Currency,Unit,Ticker,Symbol
313137,4/3/2023 3:30:00 PM,United States,3 Month Bill Yield,3-Month Bill Auction,,,Federal Reserve,http://www.treasurydirect.gov,4.78%,4.675%,,,/united-states/3-month-bill-yield,0,1,4/3/2023 3:32:15 PM,,,%,UNITEDSTA3MONBILYIE,UNITEDSTA3MONBILYIE
313138,4/3/2023 3:30:00 PM,United States,6 Month Bill Yield,6-Month Bill Auction,,,Federal Reserve,http://www.treasurydirect.gov,4.705%,4.65%,,,/united-states/6-month-bill-yield,0,1,4/3/2023 3:33:02 PM,,,%,UNITEDSTA6MONBILYIE,UNITEDSTA6MONBILYIE
338272,4/5/2023 3:30:00 PM,United States,Calendar,17-Week Bill Auction,,,,,4.750%,4.780%,,,/united-states/calendar,0,1,4/5/2023 3:34:42 PM,,,%,USD CALENDAR,

/calendar/country/{country}/group/{group}?f=xml

<ArrayOfCalendarItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CalendarItem>
<CalendarId>313137</CalendarId>
<Date>2023-04-03T15:30:00</Date>
<Country>United States</Country>
<Category>3 Month Bill Yield</Category>
<Event>3-Month Bill Auction</Event>
<Reference/>
<ReferenceDate i:nil="true"/>
<Source>Federal Reserve</Source>
<SourceURL>http://www.treasurydirect.gov</SourceURL>
<Actual>4.78%</Actual>
<Previous>4.675%</Previous>
<Forecast/>
<TEForecast/>
<URL>/united-states/3-month-bill-yield</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2023-04-03T15:32:15.98</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>UNITEDSTA3MONBILYIE</Ticker>
<Symbol>UNITEDSTA3MONBILYIE</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>313138</CalendarId>
<Date>2023-04-03T15:30:00</Date>
<Country>United States</Country>
<Category>6 Month Bill Yield</Category>
<Event>6-Month Bill Auction</Event>
<Reference/>
<ReferenceDate i:nil="true"/>
<Source>Federal Reserve</Source>
<SourceURL>http://www.treasurydirect.gov</SourceURL>
<Actual>4.705%</Actual>
<Previous>4.65%</Previous>
<Forecast/>
<TEForecast/>
<URL>/united-states/6-month-bill-yield</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2023-04-03T15:33:02.4</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>UNITEDSTA6MONBILYIE</Ticker>
<Symbol>UNITEDSTA6MONBILYIE</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>338272</CalendarId>
<Date>2023-04-05T15:30:00</Date>
<Country>United States</Country>
<Category>Calendar</Category>
<Event>17-Week Bill Auction</Event>
<Reference/>
<ReferenceDate i:nil="true"/>
<Source/>
<SourceURL/>
<Actual>4.750%</Actual>
<Previous>4.780%</Previous>
<Forecast/>
<TEForecast/>
<URL>/united-states/calendar</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2023-04-05T15:34:42.987</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>USD CALENDAR</Ticker>
<Symbol/>
</CalendarItem>
</ArrayOfCalendarItem>

By country, group and date

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/calendar/country/united%20states/group/bonds/2016-03-01/2018-03-03?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getCalendarEventsByGroup(group='bonds', country='united states',
 initDate='2016-03-01', endDate='2018-03-03')

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/country/united%20states/group/bonds/2016-03-01/2018-03-03?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getCalendarEventsByGroup(group = 'bonds', country = 'united states',
 start_date = '2016-03-01', end_date = '2018-03-03').then(function(data){
    console.log(data)     
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/country/united%20states/group/bonds/2016-03-01/2018-03-03?c=guest:guest");

/calendar/country/{country}/group/{group}/{yyy-mm-dd}/{yyy-mm-dd}

CalendarId	Date	Country	Category	Event	ReferenceDate	Source	SourceURL	Actual	Previous	TEForecast	URL	Importance	LastUpdate	Unit	Ticker	Symbol
74633	3/1/2016 4:30:00 PM	United States	4 Week Bill Yield	4-Week Bill Auction	3/31/2016 12:00:00 AM	Federal Reserve	https://www.treasurydirect.gov	0.295%	0.285%	0.29%	/united-states/4-week-bill-yield	1	3/1/2016 4:35:00 PM	%	UNITEDSTA4WEEBILYIE	UNITEDSTA4WEEBILYIE
99625	3/1/2016 4:30:00 PM	United States	52 Week Bill Yield	52-Week Bill Auction		Federal Reserve	https://www.treasurydirect.gov	0.660%	0.53%		/united-states/52-week-bill-yield	1	3/1/2016 4:35:00 PM	%	UNITEDSTA52WEEBILYIE	UNITEDSTA52WEEBILYIE
74869	3/7/2016 4:30:00 PM	United States	3 Month Bill Yield	3-Month Bill Auction	3/31/2016 12:00:00 AM	Federal Reserve	https://www.treasurydirect.gov	0.315%	0.325%	0.33%	/united-states/3-month-bill-yield	1	3/7/2016 4:44:00 PM	%	UNITEDSTA3MONBILYIE	UNITEDSTA3MONBILYIE

/calendar/country/{country}/group/{group}/{yyy-mm-dd}/{yyy-mm-dd}?f=json

[
  {
    "CalendarId": "74633",
    "Date": "2016-03-01T16:30:00",
    "Country": "United States",
    "Category": "4 Week Bill Yield",
    "Event": "4-Week Bill Auction",
    "Reference": "",
    "ReferenceDate": "2016-03-31T00:00:00",
    "Source": "Federal Reserve",
    "SourceURL": "https://www.treasurydirect.gov",
    "Actual": "0.295%",
    "Previous": "0.285%",
    "Forecast": "",
    "TEForecast": "0.29%",
    "URL": "/united-states/4-week-bill-yield",
    "DateSpan": "0",
    "Importance": 1,
    "LastUpdate": "2016-03-01T16:35:00",
    "Revised": "",
    "Currency": "",
    "Unit": "%",
    "Ticker": "UNITEDSTA4WEEBILYIE",
    "Symbol": "UNITEDSTA4WEEBILYIE"
  },
  {
    "CalendarId": "99625",
    "Date": "2016-03-01T16:30:00",
    "Country": "United States",
    "Category": "52 Week Bill Yield",
    "Event": "52-Week Bill Auction",
    "Reference": "",
    "ReferenceDate": null,
    "Source": "Federal Reserve",
    "SourceURL": "https://www.treasurydirect.gov",
    "Actual": "0.660%",
    "Previous": "0.53%",
    "Forecast": "",
    "TEForecast": "",
    "URL": "/united-states/52-week-bill-yield",
    "DateSpan": "0",
    "Importance": 1,
    "LastUpdate": "2016-03-01T16:35:00",
    "Revised": "",
    "Currency": "",
    "Unit": "%",
    "Ticker": "UNITEDSTA52WEEBILYIE",
    "Symbol": "UNITEDSTA52WEEBILYIE"
  },
  {
    "CalendarId": "74869",
    "Date": "2016-03-07T16:30:00",
    "Country": "United States",
    "Category": "3 Month Bill Yield",
    "Event": "3-Month Bill Auction",
    "Reference": "",
    "ReferenceDate": "2016-03-31T00:00:00",
    "Source": "Federal Reserve",
    "SourceURL": "http://www.treasurydirect.gov",
    "Actual": "0.315%",
    "Previous": "0.325%",
    "Forecast": "",
    "TEForecast": "0.33%",
    "URL": "/united-states/3-month-bill-yield",
    "DateSpan": "0",
    "Importance": 1,
    "LastUpdate": "2016-03-07T16:44:00",
    "Revised": "",
    "Currency": "",
    "Unit": "%",
    "Ticker": "UNITEDSTA3MONBILYIE",
    "Symbol": "UNITEDSTA3MONBILYIE"
  }
]

/calendar/country/{country}/group/{group}/{yyy-mm-dd}/{yyy-mm-dd}?f=csv

CalendarId,Date,Country,Category,Event,Reference,ReferenceDate,Source,SourceURL,Actual,Previous,Forecast,TEForecast,URL,DateSpan,Importance,LastUpdate,Revised,Currency,Unit,Ticker,Symbol
74633,3/1/2016 4:30:00 PM,United States,4 Week Bill Yield,4-Week Bill Auction,,3/31/2016 12:00:00 AM,Federal Reserve,https://www.treasurydirect.gov,0.295%,0.285%,,0.29%,/united-states/4-week-bill-yield,0,1,3/1/2016 4:35:00 PM,,,%,UNITEDSTA4WEEBILYIE,UNITEDSTA4WEEBILYIE
99625,3/1/2016 4:30:00 PM,United States,52 Week Bill Yield,52-Week Bill Auction,,,Federal Reserve,https://www.treasurydirect.gov,0.660%,0.53%,,,/united-states/52-week-bill-yield,0,1,3/1/2016 4:35:00 PM,,,%,UNITEDSTA52WEEBILYIE,UNITEDSTA52WEEBILYIE
74869,3/7/2016 4:30:00 PM,United States,3 Month Bill Yield,3-Month Bill Auction,,3/31/2016 12:00:00 AM,Federal Reserve,http://www.treasurydirect.gov,0.315%,0.325%,,0.33%,/united-states/3-month-bill-yield,0,1,3/7/2016 4:44:00 PM,,,%,UNITEDSTA3MONBILYIE,UNITEDSTA3MONBILYIE

/calendar/country/{country}/group/{group}/{yyy-mm-dd}/{yyy-mm-dd}?f=xml

<ArrayOfCalendarItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CalendarItem>
<CalendarId>74633</CalendarId>
<Date>2016-03-01T16:30:00</Date>
<Country>United States</Country>
<Category>4 Week Bill Yield</Category>
<Event>4-Week Bill Auction</Event>
<Reference/>
<ReferenceDate>2016-03-31T00:00:00</ReferenceDate>
<Source>Federal Reserve</Source>
<SourceURL>https://www.treasurydirect.gov</SourceURL>
<Actual>0.295%</Actual>
<Previous>0.285%</Previous>
<Forecast/>
<TEForecast>0.29%</TEForecast>
<URL>/united-states/4-week-bill-yield</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2016-03-01T16:35:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>UNITEDSTA4WEEBILYIE</Ticker>
<Symbol>UNITEDSTA4WEEBILYIE</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>99625</CalendarId>
<Date>2016-03-01T16:30:00</Date>
<Country>United States</Country>
<Category>52 Week Bill Yield</Category>
<Event>52-Week Bill Auction</Event>
<Reference/>
<ReferenceDate i:nil="true"/>
<Source>Federal Reserve</Source>
<SourceURL>https://www.treasurydirect.gov</SourceURL>
<Actual>0.660%</Actual>
<Previous>0.53%</Previous>
<Forecast/>
<TEForecast/>
<URL>/united-states/52-week-bill-yield</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2016-03-01T16:35:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>UNITEDSTA52WEEBILYIE</Ticker>
<Symbol>UNITEDSTA52WEEBILYIE</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>74869</CalendarId>
<Date>2016-03-07T16:30:00</Date>
<Country>United States</Country>
<Category>3 Month Bill Yield</Category>
<Event>3-Month Bill Auction</Event>
<Reference/>
<ReferenceDate>2016-03-31T00:00:00</ReferenceDate>
<Source>Federal Reserve</Source>
<SourceURL>http://www.treasurydirect.gov</SourceURL>
<Actual>0.315%</Actual>
<Previous>0.325%</Previous>
<Forecast/>
<TEForecast>0.33%</TEForecast>
<URL>/united-states/3-month-bill-yield</URL>
<DateSpan>0</DateSpan>
<Importance>1</Importance>
<LastUpdate>2016-03-07T16:44:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>UNITEDSTA3MONBILYIE</Ticker>
<Symbol>UNITEDSTA3MONBILYIE</Symbol>
</CalendarItem>
</ArrayOfCalendarItem>

By country, event and date

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/calendar/country/united%20states/event/GDP%20Growth%20Rate%20QoQ%20Final/2016-12-01/2024-02-25?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getCalendarData(country = 'united states', event = 'GDP Growth Rate QoQ Final', 
 initDate='2016-12-01', endDate='2024-02-25')

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/country/united%20states/event/GDP%20Growth%20Rate%20QoQ%20Final/2016-12-01/2024-02-25?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getCalendar(country = 'united states', event='GDP Growth Rate QoQ Final', 
 start_date='2016-12-01', end_date='2024-02-25').then(function(data){
    console.log(data)     
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/country/united%20states/event/GDP%20Growth%20Rate%20QoQ%20Final/2016-12-01/2024-02-25?c=guest:guest");

/calendar/country/{country}/event/{event}/{yyy-mm-dd}/{yyy-mm-dd}

CalendarId	Date	Country	Category	Event	Reference	ReferenceDate	Source	SourceURL	Actual	Previous	Forecast	TEForecast	URL	Importance	LastUpdate	Unit	Ticker	Symbol
86405	12/22/2016 1:30:00 PM	United States	GDP Growth Rate	GDP Growth Rate QoQ Final	Q3	9/30/2016 12:00:00 AM	U.S. Bureau of Economic Analysis	http://www.bea.gov	3.5%	1.4%	3.3%	3.2%	/united-states/gdp-growth	2	12/22/2016 1:30:00 PM	%	GDP CQOQ	GDP CQOQ
128729	3/30/2017 12:30:00 PM	United States	GDP Growth Rate	GDP Growth Rate QoQ Final	Q4	12/31/2016 12:00:00 AM	U.S. Bureau of Economic Analysis	http://www.bea.gov	2.1%	3.5%	2%	2%	/united-states/gdp-growth	2	3/30/2017 12:27:00 PM	%	GDP CQOQ	GDP CQOQ
134064	6/29/2017 12:30:00 PM	United States	GDP Growth Rate	GDP Growth Rate QoQ Final	Q1	3/31/2017 12:00:00 AM	U.S. Bureau of Economic Analysis	http://www.bea.gov	1.4%	2.1%	1.2%	1.3%	/united-states/gdp-growth	2	6/29/2017 12:30:00 PM	%	GDP CQOQ	GDP CQOQ

/calendar/country/{country}/event/{event}/{yyy-mm-dd}/{yyy-mm-dd}?f=json

[
  {
    "CalendarId": "86405",
    "Date": "2016-12-22T13:30:00",
    "Country": "United States",
    "Category": "GDP Growth Rate",
    "Event": "GDP Growth Rate QoQ Final",
    "Reference": "Q3",
    "ReferenceDate": "2016-09-30T00:00:00",
    "Source": "U.S. Bureau of Economic Analysis",
    "SourceURL": "http://www.bea.gov",
    "Actual": "3.5%",
    "Previous": "1.4%",
    "Forecast": "3.3%",
    "TEForecast": "3.2%",
    "URL": "/united-states/gdp-growth",
    "DateSpan": "0",
    "Importance": 2,
    "LastUpdate": "2016-12-22T13:30:00",
    "Revised": "",
    "Currency": "",
    "Unit": "%",
    "Ticker": "GDP CQOQ",
    "Symbol": "GDP CQOQ"
  },
  {
    "CalendarId": "128729",
    "Date": "2017-03-30T12:30:00",
    "Country": "United States",
    "Category": "GDP Growth Rate",
    "Event": "GDP Growth Rate QoQ Final",
    "Reference": "Q4",
    "ReferenceDate": "2016-12-31T00:00:00",
    "Source": "U.S. Bureau of Economic Analysis",
    "SourceURL": "http://www.bea.gov",
    "Actual": "2.1%",
    "Previous": "3.5%",
    "Forecast": "2%",
    "TEForecast": "2%",
    "URL": "/united-states/gdp-growth",
    "DateSpan": "0",
    "Importance": 2,
    "LastUpdate": "2017-03-30T12:27:00",
    "Revised": "",
    "Currency": "",
    "Unit": "%",
    "Ticker": "GDP CQOQ",
    "Symbol": "GDP CQOQ"
  },
  {
    "CalendarId": "134064",
    "Date": "2017-06-29T12:30:00",
    "Country": "United States",
    "Category": "GDP Growth Rate",
    "Event": "GDP Growth Rate QoQ Final",
    "Reference": "Q1",
    "ReferenceDate": "2017-03-31T00:00:00",
    "Source": "U.S. Bureau of Economic Analysis",
    "SourceURL": "http://www.bea.gov",
    "Actual": "1.4%",
    "Previous": "2.1%",
    "Forecast": "1.2%",
    "TEForecast": "1.3%",
    "URL": "/united-states/gdp-growth",
    "DateSpan": "0",
    "Importance": 2,
    "LastUpdate": "2017-06-29T12:30:00",
    "Revised": "",
    "Currency": "",
    "Unit": "%",
    "Ticker": "GDP CQOQ",
    "Symbol": "GDP CQOQ"
  }
]

/calendar/country/{country}/event/{event}/{yyy-mm-dd}/{yyy-mm-dd}?f=csv

CalendarId	Date	Country	Category	Event	Reference	ReferenceDate	Source	SourceURL	Actual	Previous	Forecast	TEForecast	URL	DateSpan	Importance	LastUpdate	Revised	Currency	Unit	Ticker	Symbol
86405	12/22/2016 1:30:00 PM	United States	GDP Growth Rate	GDP Growth Rate QoQ Final	Q3	9/30/2016 12:00:00 AM	U.S. Bureau of Economic Analysis	http://www.bea.gov	3.5%	1.4%	3.3%	3.2%	/united-states/gdp-growth	0	2	12/22/2016 1:30:00 PM			%	GDP CQOQ	GDP CQOQ
128729	3/30/2017 12:30:00 PM	United States	GDP Growth Rate	GDP Growth Rate QoQ Final	Q4	12/31/2016 12:00:00 AM	U.S. Bureau of Economic Analysis	http://www.bea.gov	2.1%	3.5%	2%	2%	/united-states/gdp-growth	0	2	3/30/2017 12:27:00 PM			%	GDP CQOQ	GDP CQOQ
134064	6/29/2017 12:30:00 PM	United States	GDP Growth Rate	GDP Growth Rate QoQ Final	Q1	3/31/2017 12:00:00 AM	U.S. Bureau of Economic Analysis	http://www.bea.gov	1.4%	2.1%	1.2%	1.3%	/united-states/gdp-growth	0	2	6/29/2017 12:30:00 PM			%	GDP CQOQ	GDP CQOQ

/calendar/country/{country}/event/{event}/{yyy-mm-dd}/{yyy-mm-dd}?f=xml

<ArrayOfCalendarItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CalendarItem>
<CalendarId>86405</CalendarId>
<Date>2016-12-22T13:30:00</Date>
<Country>United States</Country>
<Category>GDP Growth Rate</Category>
<Event>GDP Growth Rate QoQ Final</Event>
<Reference>Q3</Reference>
<ReferenceDate>2016-09-30T00:00:00</ReferenceDate>
<Source>U.S. Bureau of Economic Analysis</Source>
<SourceURL>http://www.bea.gov</SourceURL>
<Actual>3.5%</Actual>
<Previous>1.4%</Previous>
<Forecast>3.3%</Forecast>
<TEForecast>3.2%</TEForecast>
<URL>/united-states/gdp-growth</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2016-12-22T13:30:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>GDP CQOQ</Ticker>
<Symbol>GDP CQOQ</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>128729</CalendarId>
<Date>2017-03-30T12:30:00</Date>
<Country>United States</Country>
<Category>GDP Growth Rate</Category>
<Event>GDP Growth Rate QoQ Final</Event>
<Reference>Q4</Reference>
<ReferenceDate>2016-12-31T00:00:00</ReferenceDate>
<Source>U.S. Bureau of Economic Analysis</Source>
<SourceURL>http://www.bea.gov</SourceURL>
<Actual>2.1%</Actual>
<Previous>3.5%</Previous>
<Forecast>2%</Forecast>
<TEForecast>2%</TEForecast>
<URL>/united-states/gdp-growth</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2017-03-30T12:27:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>GDP CQOQ</Ticker>
<Symbol>GDP CQOQ</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>134064</CalendarId>
<Date>2017-06-29T12:30:00</Date>
<Country>United States</Country>
<Category>GDP Growth Rate</Category>
<Event>GDP Growth Rate QoQ Final</Event>
<Reference>Q1</Reference>
<ReferenceDate>2017-03-31T00:00:00</ReferenceDate>
<Source>U.S. Bureau of Economic Analysis</Source>
<SourceURL>http://www.bea.gov</SourceURL>
<Actual>1.4%</Actual>
<Previous>2.1%</Previous>
<Forecast>1.2%</Forecast>
<TEForecast>1.3%</TEForecast>
<URL>/united-states/gdp-growth</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2017-06-29T12:30:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>%</Unit>
<Ticker>GDP CQOQ</Ticker>
<Symbol>GDP CQOQ</Symbol>
</CalendarItem>
</ArrayOfCalendarItem>

Date format

Calendar methods described above support string dates in different formats

Date Format	Example
yyyy-MM-dd	2018-01-01
yyyy-mm-dd HH:mm	2016-12-03 23:59:59