Documentation

Card type

definition

A word with pronunciation, senses, examples and origin.

Version 1 · schema definition.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
wordstringyes
langlanguage tagyesBCP 47 language tag.
phoneticstring | nullIPA transcription.
word_of_the_daybooleanyes
entries[]object[]yes
entries[].part_of_speechstringyes
entries[].senses[]object[]yes
entries[].senses[].definitionstringyes
entries[].senses[].examplestring | null
originstring | null

Example

A recorded answer to “What does serendipity mean?”. Open it in the Answer Lab to see every layout and style.

Response
{
  "v": 2,
  "id": "ans_gn0w0sgh1np25jh4",
  "matched": true,
  "locale": "en",
  "skill": "translate",
  "confidence": 0.9,
  "text": "serendipity: The happy chance of finding something good or useful by accident.",
  "speech": "serendipity: The happy chance of finding something good or useful by accident.",
  "card": {
    "type": "definition",
    "version": 1,
    "data": {
      "word": "serendipity",
      "lang": "en",
      "phonetic": "/ˌserənˈdipəti/",
      "word_of_the_day": false,
      "entries": [
        {
          "part_of_speech": "noun",
          "senses": [
            {
              "definition": "The happy chance of finding something good or useful by accident.",
              "example": "Finding that lost book was a wonderful bit of serendipity."
            }
          ]
        }
      ],
      "origin": null
    }
  },
  "sources": [],
  "follow_ups": [],
  "actions": [],
  "usage": {
    "billable": true
  }
}