Holidays API: On This Day Service

Request Parameters:

See also the section “General Parameters”.

csv_person

To use this template, specify this parameter combination: out=text&template=csv_person.

This template is used to retrieve births/deaths in CSV format. This template can only be used with types births and deaths. Requesting this template with the type events will result in an error.

csv_event

To use this template, specify this parameter combination: out=text&template=csv_event.

This template is used to retrieve events in CSV format. This template can only be used with the type events. Requesting this template with the types births and deaths will result in an error.

xlsx_person

To use this template, specify this parameter combination: out=blob&template=xlsx_person.

This template is used to retrieve a binary file of births/deaths in an Excel/Office Open XML format. This template can only be used with types births and deaths. Requesting this template with the type events will result in an error.

The template returns a binary file with the MIME type set to application/vnd.openxmlformats-officedocument.spreadsheetml.sheet. Ideally, the contents of this binary file would be saved to disk, or served to a user, as an .xlsx file.

xlsx_event

To use this template, specify this parameter combination: out=blob&template=xlsx_event.

This template is used to retrieve a binary file of events in an Excel/Office Open XML format. This template can only be used with type events. Requesting this template with the types births or deaths will result in an error.

The template returns a binary file with the MIME type set to application/vnd.openxmlformats-officedocument.spreadsheetml.sheet. Ideally, the contents of this binary file would be saved to disk, or served to a user, as an .xlsx file.

Example JSON Request:

Example JSON response

{
	"version": 3,
	"billing": {
		"credits": 1
	},
	"events": [{
		"id": 717,
		"name": [{
			"lang": "en",
			"text": "Corazon Aquino is sworn in as the 11th President of the Philippines"
		}],
		"date": {
			"iso": "1986-02-25",
			"datetime": {
				"year": 1986,
				"month": 2,
				"day": 25
			}
		},
		"location": null,
		"categories": ["Current Events/ Politics/ National"],
		"countries": [{
			"id": "ph",
			"name": "Philippines"
		}],
		"description": [{
			"lang": "en",
			"text": "Aquino's presidency ended 20 years of dictatorship. She was the first female president in Asia."
		}]
	},{
		"id": 715,
		"name": [{
			"lang": "en",
			"text": "The state of Prussia is dissolved"
		}],
		"date": {
			"iso": "1947-02-25",
			"datetime": {
				"year": 1947,
				"month": 2,
				"day": 25
			}
		},
		"location": null,
		"categories": ["Current Events/ Politics/ Regional"],
		"countries": [{
			"id": "de",
			"name": "Germany"
		}],
		"description": [{
			"lang": "en",
			"text": "At its peak, the most important state of the German empire encompassed parts of modern-day Germany, Poland, and Russia."
		}]
	},{
		"id": 716,
		"name": [{
			"lang": "en",
			"text": "Muhammad Ali becomes world heavyweight champion"
		}],
		"date": {
			"iso": "1964-02-25",
			"datetime": {
				"year": 1964,
				"month": 2,
				"day": 25
			}
		},
		"location": "Miami",
		"categories": ["Entertainment/ Sports"],
		"countries": [{
			"id": "us",
			"name": "United States"
		}],
		"description": [{
			"lang": "en",
			"text": "Ali, who still used his original name Cassius Clay at the time, is considered one of the greatest heavyweight boxers in history."
		}]
	},{
		"id": 718,
		"name": [{
			"lang": "en",
			"text": "The Warsaw Pact is declared disbanded"
		}],
		"date": {
			"iso": "1991-02-25",
			"datetime": {
				"year": 1991,
				"month": 2,
				"day": 25
			}
		},
		"location": "Budapest",
		"categories": ["Current Events/ Politics/ International"],
		"countries": [{
			"id": "ru",
			"name": "Russia"
		},{
			"id": "al",
			"name": "Albania"
		},{
			"id": "bg",
			"name": "Bulgaria"
		},{
			"id": "de",
			"name": "Germany"
		},{
			"id": "pl",
			"name": "Poland"
		},{
			"id": "ro",
			"name": "Romania"
		},{
			"id": "cz",
			"name": "Czechia"
		},{
			"id": "sk",
			"name": "Slovakia"
		},{
			"id": "hu",
			"name": "Hungary"
		}],
		"description": [{
			"lang": "en",
			"text": "Following the end of the Cold War, the defense treaty between 8 communist states had lost its purpose. It had been signed in 1955 as an antagonist of NATO."
		}]
	},{
		"id": 719,
		"name": [{
			"lang": "en",
			"text": "An Israeli doctor kills 30 unarmed Palestinians in the Mosque of Abraham"
		}],
		"date": {
			"iso": "1994-02-25",
			"datetime": {
				"year": 1994,
				"month": 2,
				"day": 25
			}
		},
		"location": "Hebron",
		"categories": ["Current Events/ Terrorist Attacks",
		"Current Events/ War"],
		"countries": [{
			"id": "il",
			"name": "Israel"
		},{
			"id": "ps",
			"name": "Palestinian Territories"
		}],
		"description": [{
			"lang": "en",
			"text": "The massacre by right-wing extremist Baruch Goldstein was widely condemned, also in Israel."
		}]
	}]
}
    Expand code

Example XML Request:

Example XML response:

<?xml version="1.0" encoding="UTF-8"?>
<data version="3">
  <billing>
    <credits>1</credits>
  </billing>
  <events>
    <event id="717">
      <name>
        <text lang="en">Corazon Aquino is sworn in as the 11th President of the Philippines</text>
      </name>
      <date iso="1986-02-25">
        <datetime>
          <year>1986</year>
          <month>2</month>
          <day>25</day>
        </datetime>
      </date>
      <location></location>
      <categories>
        <category>Current Events/ Politics/ National</category>
      </categories>
      <countries>
        <country id="ph">Philippines</country>
      </countries>
      <description>
        <text lang="en">Aquino's presidency ended 20 years of dictatorship. She was the first female president in Asia.</text>
      </description>
    </event>
    <event id="715">
      <name>
        <text lang="en">The state of Prussia is dissolved</text>
      </name>
      <date iso="1947-02-25">
        <datetime>
          <year>1947</year>
          <month>2</month>
          <day>25</day>
        </datetime>
      </date>
      <location></location>
      <categories>
        <category>Current Events/ Politics/ Regional</category>
      </categories>
      <countries>
        <country id="de">Germany</country>
      </countries>
      <description>
        <text lang="en">At its peak, the most important state of the German empire encompassed parts of modern-day Germany, Poland, and Russia.</text>
      </description>
    </event>
    <event id="716">
      <name>
        <text lang="en">Muhammad Ali becomes world heavyweight champion</text>
      </name>
      <date iso="1964-02-25">
        <datetime>
          <year>1964</year>
          <month>2</month>
          <day>25</day>
        </datetime>
      </date>
      <location>Miami</location>
      <categories>
        <category>Entertainment/ Sports</category>
      </categories>
      <countries>
        <country id="us">United States</country>
      </countries>
      <description>
        <text lang="en">Ali, who still used his original name Cassius Clay at the time, is considered one of the greatest heavyweight boxers in history.</text>
      </description>
    </event>
    <event id="718">
      <name>
        <text lang="en">The Warsaw Pact is declared disbanded</text>
      </name>
      <date iso="1991-02-25">
        <datetime>
          <year>1991</year>
          <month>2</month>
          <day>25</day>
        </datetime>
      </date>
      <location>Budapest</location>
      <categories>
        <category>Current Events/ Politics/ International</category>
      </categories>
      <countries>
        <country id="ru">Russia</country>
        <country id="al">Albania</country>
        <country id="bg">Bulgaria</country>
        <country id="de">Germany</country>
        <country id="pl">Poland</country>
        <country id="ro">Romania</country>
        <country id="cz">Czechia</country>
        <country id="sk">Slovakia</country>
        <country id="hu">Hungary</country>
      </countries>
      <description>
        <text lang="en">Following the end of the Cold War, the defense treaty between 8 communist states had lost its purpose. It had been signed in 1955 as an antagonist of NATO.</text>
      </description>
    </event>
    <event id="719">
      <name>
        <text lang="en">An Israeli doctor kills 30 unarmed Palestinians in the Mosque of Abraham</text>
      </name>
      <date iso="1994-02-25">
        <datetime>
          <year>1994</year>
          <month>2</month>
          <day>25</day>
        </datetime>
      </date>
      <location>Hebron</location>
      <categories>
        <category>Current Events/ Terrorist Attacks</category>
        <category>Current Events/ War</category>
      </categories>
      <countries>
        <country id="il">Israel</country>
        <country id="ps">Palestinian Territories</country>
      </countries>
      <description>
        <text lang="en">The massacre by right-wing extremist Baruch Goldstein was widely condemned, also in Israel.</text>
      </description>
    </event>
  </events>
</data>
    Expand code

Example Simple CSV Event Request:

Example Simple CSV Event response:

Date,Name,Location,Categories,Countries,Description
1986-02-25,Corazon Aquino is sworn in as the 11th President of the Philippines,,Current Events/ Politics/ National,Philippines,
1947-02-25,The state of Prussia is dissolved,,Current Events/ Politics/ Regional,Germany,
1964-02-25,Muhammad Ali becomes world heavyweight champion,Miami,Entertainment/ Sports,United States,
1991-02-25,The Warsaw Pact is declared disbanded,Budapest,Current Events/ Politics/ International,"Russia,Albania,Bulgaria,Germany,Poland,Romania,Czechia,Slovakia,Hungary",
1994-02-25,An Israeli doctor kills 30 unarmed Palestinians in the Mosque of Abraham,Hebron,"Current Events/ Terrorist Attacks,Current Events/ War","Israel,Palestinian Territories",
    Expand code

Example CSV Person Request:

Example CSV Person response

First name,Middle name,Last name,Birth date,Death date,Categories,Nationalities
Mark,,Rothko,1903-09-25,1970-02-25,painter,"Latvian,American"
Donald,,Bradman,1908-08-27,2001-02-25,cricketer,Australian
Elijah,,Muhammad,1897-10-07,1975-02-25,religious leader,American
,,Emperor Dezong of Tang,0742-05-27,0805-02-25,,
Christopher,,Wren,1632-10-20,1723-02-25,"architect,designed St Paul's Cathedral",English
Paco,de,Lucía,1947-12-21,2014-02-25,"guitarist,songwriter",Spanish
Glenn,T.,Seaborg,1912-04-19,1999-02-25,"chemist,Nobel Prize laureate",American
Tennessee,,Williams,1911-03-26,1983-02-25,"playwright,author,poet",American
William,,"O'Brien",,1928-02-25,"author,journalist,politician",Irish
C.,Everett,Koop,1916-10-14,2013-02-25,"surgeon,public health administrator,13th United States Surgeon General",American
Thomas,,Pownall,,1805-02-25,"politician,Governor of the Province of Massachusetts Bay",English
Mário,de,Andrade,1893-10-09,1945-02-25,"author,poet,photographer",Brazilian
Jersey,Joe,Walcott,1914-01-31,1994-02-25,boxer,American
,,"Robert Devereux, 2nd Earl of Essex",1566-11-10,1601-02-25,"general,politician",English
Hans,Raj,Khanna,,2008-02-25,judge,Indian
Thomas,,Moore,1779-05-28,1852-02-25,"poet,composer",Irish
Jang,Bahadur,Rana,,1877-02-25,ruler,Nepalese
Philip,José,Farmer,1918-01-26,2009-02-25,author,American
John,,McGraw,1873-04-07,1934-02-25,"baseball player,manager",American
Eliza,,Haywood,,1756-02-25,"actress,poet",English
Samuel,,Seabury,,1796-02-25,bishop,American
Albrecht,von,Wallenstein,1583-09-24,1634-02-25,general,Austrian
John,,Tenniel,1820-02-28,1914-02-25,illustrator,English
Celestine,Tate,Harrington,,1998-02-25,"keyboard player,author",American
Daoguang,,Emperor,1782-09-16,1850-02-25,of China,
Stewart,"""Dirk""",Fischer,,2013-02-25,"trumpet player,composer",American
Sigurd,,Raschèr,,2001-02-25,saxophonist,"German,American"
Bugs,,Moran,,1957-02-25,gangster,American
A.,R.,Ammons,,2001-02-25,poet,American
Darren,,McGavin,1922-05-07,2006-02-25,"actor,director",American
Ben,,Bowen,2002-11-14,2005-02-25,brain cancer victim,American
Alexander,,Archipenko,1887-05-30,1964-02-25,sculptor,Ukrainian
İhsan,,Doğramacı,1915-04-03,2010-02-25,"physician,academic",Turkish
Eddie,,Constantine,1917-10-29,1993-02-25,"actor,singer","American,French"
Alberto,,Sordi,1920-06-15,2003-02-25,"actor,director",Italian
Tom,,"O'Higgins",,2003-02-25,"politician,judge,6th Chief Justice of Ireland",Irish
,,Francisco Manoel de Nascimento,,1819-02-25,poet,Portuguese
Ray,,"O'Connor",1926-03-06,2013-02-25,"politician,22nd Premier of Western Australia",Australian
Marcel-Auguste,,Dieulafoy,,1920-02-25,archaeologist,French
William,,Anderson,,2007-02-25,"navy officer,politician",American
Paul,,Reuter,1816-07-21,1899-02-25,journalist,"German,English"
James,D.,Norris,1906-11-06,1966-02-25,businessman,American
William,,Lily,,1522-02-25,scholar,English
David,,Bowman,1860-08-24,1916-02-25,politician,Australian
Willy,,Rizzo,,2013-02-25,photographer,Italian
,,Frederick I of Prussia,1657-07-11,1713-02-25,,
Anton,,Arensky,1861-07-12,1906-02-25,"composer,pianist,educator",Russian
Kenneth,Lee,Spencer,1913-04-25,1964-02-25,"opera singer,actor",American
Melville,J.,Herskovits,,1963-02-25,anthropologist,American
Steele,,MacKaye,,1894-02-25,"actor,playwright",American
Josif,,Pančić,1814-04-17,1888-02-25,botanist,Serbian
Anna,,Harrison,,1864-02-25,"wife of William Henry Harrison,9th First Lady of the United States",American
Mary,,Walter,1912-09-10,1993-02-25,actress,Filipino
Friedrich,Maximilian,Klinger,1752-02-17,1831-02-25,"author,playwright",German
Haing,S.,Ngor,1940-03-22,1996-02-25,"physician,actor,author","Cambodian,American"
W.,O.,Mitchell,1914-03-13,1998-02-25,"author,broadcaster",Canadian
Daniel,"James,",Jr.,1920-02-11,1978-02-25,"pilot,general",American
Erland,,Josephson,1923-06-15,2012-02-25,"actor,director",Swedish
Dafydd,ap,Llywelyn,,1246-02-25,king,Welsh
Angèle,,Arsenault,1943-10-01,2014-02-25,singer-songwriter,Canadian
Allan,B.,Calhamer,1931-12-07,2013-02-25,"game designer,created Diplomacy",American
James,,Coco,1930-03-21,1987-02-25,actor,American
William,,Pinkney,,1822-02-25,"politician,diplomat,7th United States Attorney General",American
Friedrich,,Spielhagen,,1911-02-25,author,German
,,"William IV, Grand Duke of Luxembourg",1852-04-22,1912-02-25,,
George,,Minot,1885-12-02,1950-02-25,"physician,Nobel Prize laureate",American
Charles,Edwin,Bessey,,1915-02-25,botanist,American
Jim,,Lange,1933-08-15,2014-02-25,game show host,American
Albert,,Chartier,1912-06-16,2004-02-25,"cartoonist,illustrator","French,Canadian"
Sergei,,Winogradsky,1856-09-01,1953-02-25,scientist,"Ukrainian,Russian"
Robert,,Hayden,1913-08-04,1980-02-25,poet,American
Johnny,,Burke,1908-10-03,1964-02-25,songwriter,American
Worthington,,Whittredge,,1910-02-25,painter,American
Peter,,Benenson,1921-07-31,2005-02-25,"lawyer,activist,founder of Amnesty International",English
Townsend,,Harris,1804-10-03,1878-02-25,politician,American
Harve,,Bennett,1930-08-17,2015-02-25,"television,film producer,screenwriter",American
Carmen,,Montejo,,2013-02-25,actress,"Cuban,Mexican"
Hinrich,,Lohse,,1964-02-25,politician,German
Henri,Désiré,Landru,1869-04-12,1922-02-25,serial killer,French
Andrei,,Sinyavsky,,1997-02-25,"journalist,publisher",Russian
Clem,,Windsor,1923-02-02,2007-02-25,"rugby union player,surgeon",Australian
Static,,Major,1974-11-11,2008-02-25,"singer-songwriter,producer",American
Philip,Pendleton,Barbour,1783-05-25,1841-02-25,"politician,12th Speaker of the United States House of Representatives",American
Grace,,Metalious,1924-09-08,1964-02-25,novelist,American
Daniel,,Heinsius,1580-06-09,1655-02-25,scholar,Belgian
Mariano,Jesús,Cuenco,,1964-02-25,politician,Filipino
Norbert,,Glanzberg,,2001-02-25,composer,"Polish,French"
Herb,,Epp,,2013-02-25,"politician,Mayor of Waterloo",Canadian
Alessandro,,Stradella,1639-04-03,1682-02-25,composer,Italian
Eleanor,of,Austria,1498-11-15,1558-02-25,,
Cal,,Abrams,1924-03-02,1997-02-25,baseball player,American
Abdelhamid,Abou,Zeid,,2013-02-25,terrorist,Algerian
Edward,,Patten,1939-08-27,2005-02-25,"singer-songwriter,producer",American
Gyula,,Kakas,,1928-02-25,gymnast,Hungarian
Phillip,,Leishman,,2013-02-25,television host,New Zealand
John,"Cowles,",Sr.,,1983-02-25,"publisher,founded the Cowles Media Company",American
Walter,,Koch,1895-09-18,1970-02-25,. German astrologer,
Mark,,Spoelstra,1940-06-30,2007-02-25,"singer-songwriter,guitarist",American
Ralph,P.,Martin,,2013-02-25,scholar,English
Pu,,Songling,1640-06-05,1715-02-25,author,Chinese
Chauncey,Allen,Goodrich,1790-10-23,1860-02-25,clergyman,American
Theodor,,Svedberg,1884-08-30,1971-02-25,"chemist,physicist,Nobel Prize laureate",Swedish
Margaret,,Tafoya,,2001-02-25,potter,American
Auguste,,Perret,,1954-02-25,"architect,designed the Théâtre des Champs-Élysées",French
Luce,,Maced,,2000-02-25,super-centenarian,French
,,Louis Jules Mancini Mazarini,1716-12-16,1798-02-25,diplomat,French
Berchtold,,Haller,,1536-02-25,reformer,"German,Swiss"
Mark,,Aldanov,,1957-02-25,"author,critic",Russian
Josef,,Christiaens,,1919-02-25,race car driver,Belgian
Charles,,Chan,,2008-02-25,actor,Chinese
Samuel,,Kivuitu,,2013-02-25,politician,Kenyan
Thomas,,Koppel,,2006-02-25,"pianist,composer",Danish
Maurice,,André,1933-05-21,2012-02-25,trumpet player,French
Hirate,,Masahide,,1553-02-25,samurai,Japanese
Marco,da,Gagliano,1582-05-01,1643-02-25,composer,Italian
Henrik,,Hertz,,1870-02-25,poet,Danish
Baruch,,Goldstein,,1994-02-25,"physician,mass murderer","American,Israeli"
Mary,Mills,Patrick,,1940-02-25,author,American
L.,R.,Wright,1939-06-05,2001-02-25,author,Canadian
Charlie,,Wayman,,2006-02-25,footballer,English
Ashley,,Cooper,,2008-02-25,race car driver,Australian
Milan,,Velimirović,,2013-02-25,chess player,Serbian
Buck,,Compton,,2012-02-25,"lawyer,judge",American
John,,McGraw,,1934-02-25,"baseball player,manager",American
Margaret,,Meagher,,1999-02-25,diplomat,Canadian
Donald,,Hings,,2004-02-25,"inventor,invented the Walkie-talkie",Canadian
David,,Logan,,1964-02-25,politician,Scottish
Dan,,Toler,1948-09-23,2013-02-25,guitarist,American
Maurice,,Farman,1877-03-21,1964-02-25,"race car driver,pilot",French
Otto,,Ludwig,1813-02-11,1865-02-25,"author,playwright,critic",German
Leo,,Labine,1931-07-22,2005-02-25,ice hockey player,Canadian
Elizabeth,Gertrude,Britton,,1934-02-25,botanist,American
André,,Turp,,1991-02-25,tenor,Canadian
,,"Daniel Greysolon, Sieur du Lhut",,1710-02-25,"soldier,explorer",French
Stanoje,,Glavaš,,1815-02-25,soldier,Serbian
Jung,Bahadur,Rana,1816-06-18,1877-02-25,ruler,Nepali
René,Le,Grèves,1910-07-06,1946-02-25,cyclist,French
Bernard,,Ashmole,1894-06-22,1988-02-25,"archaeologist,art historian",English
Philip,,Babington,1894-02-25,1965-02-25,,English Air Marshal
Chokwe,,Lumumba,,2014-02-25,"lawyer,politician",American
Terry,,Gill,,2015-02-25,actor,"English,Australian"
Ashley,,Cooper,,2008-02-25,race car driver,Australian
Red,,Holloway,,2012-02-25,saxophonist,American
Martha,,Stewart,,2012-02-25,"actress,singer",American
Nikos,,Alexiou,,2011-02-25,"painter,set designer",Greek
Victor,,Watson,,2015-02-25,"businessman,philanthropist",English
Eugenie,,Clark,1922-05-04,2015-02-25,"biologist,academic",American
Quentin,,Elias,,2014-02-25,"singer,actor","French,American"
Vehbi,,Koç,1901-07-20,1996-02-25,"businessman,philanthropist,founded Koç Holding",Turkish
A.,,Vincent,,2015-02-25,"director,cinematographer",Indian
Lynn,,Compton,,2012-02-25,"lieutenant,lawyer,judge",American
Louisiana,,Red,,2012-02-25,"singer-songwriter,guitarist",American
,,"Marie Cathcart, Countess Cathcart",,2015-02-25,,
Sultan,,Cem,,1495-02-25,politician,Ottoman
Mário,,Coluna,,2014-02-25,footballer,Portuguese
Georg,,Olden,,1975-02-25,graphic designer,"African,American"
    Expand code