Numbers API · Schema

Fact

A single Numbers API fact returned in JSON form.

Science And MathPublic APIsTriviaNumbersDatesOpen Source

Properties

Name	Type	Description
text	string	Plain-text fact about the number.
number	number	Floating-point number the fact pertains to. For date facts, this is the 1-indexed day of a leap year (e.g. 61 is March 1).
found	boolean	Whether a real fact was found for the requested number.
type	string	Category of the returned fact.
date	string	Day of year associated with year facts, as a string (e.g. `June 6`).
year	string	Year associated with date facts, as a string (e.g. `1969`).

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/numbers/refs/heads/main/json-schema/numbers-fact-schema.json",
  "title": "Fact",
  "description": "A single Numbers API fact returned in JSON form.",
  "type": "object",
  "required": ["text", "number", "found", "type"],
  "properties": {
    "text": {
      "type": "string",
      "description": "Plain-text fact about the number.",
      "example": "42 is the result given by Google and Bing for the query \"the answer to life the universe and everything\"."
    },
    "number": {
      "type": "number",
      "description": "Floating-point number the fact pertains to. For date facts, this is the 1-indexed day of a leap year (e.g. 61 is March 1).",
      "example": 42
    },
    "found": {
      "type": "boolean",
      "description": "Whether a real fact was found for the requested number.",
      "example": true
    },
    "type": {
      "type": "string",
      "description": "Category of the returned fact.",
      "enum": ["trivia", "math", "date", "year"],
      "example": "trivia"
    },
    "date": {
      "type": "string",
      "description": "Day of year associated with year facts, as a string (e.g. `June 6`).",
      "example": "June 6"
    },
    "year": {
      "type": "string",
      "description": "Year associated with date facts, as a string (e.g. `1969`).",
      "example": "1969"
    }
  }
}