Card type

`timer`

A countdown the client runs. Comes with a timer.start action.

Version 1 · schema timer.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.

Field	Type	Required	Notes
`label`	`string`	yes
`duration_s`	`integer`	yes
`started_at`	`date-time`	yes	ISO 8601 date-time with offset.
`ends_at`	`date-time`	yes	ISO 8601 date-time with offset.

Example

A recorded answer to “Set a pasta timer for 8 minutes”. Open it in the Answer Lab to see every layout and style.

Response

1{
2  "v": 2,
3  "id": "ans_7c686ee4ea50",
4  "matched": true,
5  "locale": "en",
6  "skill": "timer",
7  "confidence": 0.99,
8  "text": "Pasta timer set for 8 minutes, until 14:08.",
9  "speech": "Okay, 8 minutes for the pasta.",
10  "card": {
11    "type": "timer",
12    "version": 1,
13    "data": {
14      "label": "Pasta",
15      "duration_s": 480,
16      "started_at": "2026-10-21T14:00:00+02:00",
17      "ends_at": "2026-10-21T14:08:00+02:00"
18    }
19  },
20  "sources": [],
21  "follow_ups": [
22    "Add one minute",
23    "Cancel the timer"
24  ],
25  "actions": [
26    {
27      "type": "timer.start",
28      "label": "Pasta",
29      "duration_s": 480
30    }
31  ],
32  "usage": {
33    "billable": true
34  }
35}