Documentación

La documentación para desarrolladores está en inglés.

Tipo de tarjeta

on_this_day

Historical events and observances for a date.

Version 1 · schema on_this_day.v1.schema.json

Layouts

Every card type has full. Pick a layout with the element's layout attribute, render.layout, or a theme.

Fields

The fields of card.data. Values a source doesn't provide are null; new optional fields can appear within version 1.

FieldTypeRequiredNotes
datedateyesISO 8601 calendar date.
events[]object[]yes
events[].yearintegeryesNegative for years BC.
events[].textstringyes
events[].featuredbooleanThe event the text leads with; compact layouts show it. At most one is true; events stay in chronological order.
events[].source_urlurl | null
observances[]object[]yes
observances[].namestringyes
observances[].regionstring | nullyes

Example

A recorded answer to “What happened on this day in history?”. Open it in the Answer Lab to see every layout and style.

Response
{
  "v": 2,
  "id": "ans_0tjhlcau6dxf873p",
  "matched": true,
  "locale": "en",
  "skill": "today",
  "confidence": 0.9,
  "text": "On this day in 1994: In Seoul, South Korea, 32 people were killed and 17 others injured when a span of the Seongsu Bridge collapsed.\n1096: First Crusade: At the Battle of Civetot, the Seljuk forces of Kilij Arslan destroyed the army of the People's Crusade as it marched toward Nicaea.\n1345: Hundred Years' War: The English victory at the Battle of Auberoche marked a change in the military balance of power in Aquitaine, with the subsequent collapse of the French position.\n1858: French composer Jacques Offenbach's operetta Orpheus in the Underworld, featuring the music most associated with the can-can (audio featured), was first performed at the Théâtre des Bouffes-Parisiens in Paris.",
  "speech": "On this day in 1994: In Seoul, South Korea, 32 people were killed and 17 others injured when a span of the Seongsu Bridge collapsed.",
  "card": {
    "type": "on_this_day",
    "version": 1,
    "data": {
      "date": "2026-10-21",
      "events": [
        {
          "year": 1096,
          "text": "First Crusade: At the Battle of Civetot, the Seljuk forces of Kilij Arslan destroyed the army of the People's Crusade as it marched toward Nicaea.",
          "featured": false,
          "source_url": "https://en.wikipedia.org/wiki/First_Crusade"
        },
        {
          "year": 1345,
          "text": "Hundred Years' War: The English victory at the Battle of Auberoche marked a change in the military balance of power in Aquitaine, with the subsequent collapse of the French position.",
          "featured": false,
          "source_url": "https://en.wikipedia.org/wiki/Hundred_Years'_War"
        },
        {
          "year": 1858,
          "text": "French composer Jacques Offenbach's operetta Orpheus in the Underworld, featuring the music most associated with the can-can (audio featured), was first performed at the Théâtre des Bouffes-Parisiens in Paris.",
          "featured": false,
          "source_url": "https://en.wikipedia.org/wiki/Jacques_Offenbach"
        },
        {
          "year": 1910,
          "text": "HMS Niobe arrived in Halifax Harbour to become the first large ship of the Royal Canadian Navy.",
          "featured": false,
          "source_url": "https://en.wikipedia.org/wiki/HMS_Niobe_(1897)"
        },
        {
          "year": 1959,
          "text": "The Solomon R. Guggenheim Museum, designed by American architect Frank Lloyd Wright, opened in New York City.",
          "featured": false,
          "source_url": "https://en.wikipedia.org/wiki/Solomon_R._Guggenheim_Museum"
        },
        {
          "year": 1966,
          "text": "A coal tip fell on the village of Aberfan, Wales, killing 144 people, mostly schoolchildren.",
          "featured": false,
          "source_url": "https://en.wikipedia.org/wiki/Spoil_tip"
        },
        {
          "year": 1968,
          "text": "At the height of the Japanese university protests, protesters occupied Shinjuku Station in Tokyo and clashed violently with police.",
          "featured": false,
          "source_url": "https://en.wikipedia.org/wiki/1968%E2%80%931969_Japanese_university_protests"
        },
        {
          "year": 1994,
          "text": "In Seoul, South Korea, 32 people were killed and 17 others injured when a span of the Seongsu Bridge collapsed.",
          "featured": true,
          "source_url": "https://en.wikipedia.org/wiki/Seoul"
        }
      ],
      "observances": []
    }
  },
  "sources": [
    {
      "name": "Wikipedia",
      "url": "https://en.wikipedia.org/wiki/October_21",
      "license": "CC BY-SA 4.0"
    }
  ],
  "follow_ups": [],
  "actions": [],
  "usage": {
    "billable": true
  }
}