Numbers API · JSON Structure

Numbers Fact Structure

A single Numbers API fact returned in JSON form.

Type: object Properties: 6 Required: 4
Science And MathPublic APIsTriviaNumbersDatesOpen Source

Fact is a JSON Structure definition published by Numbers API, describing 6 properties, of which 4 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

text number found type date year

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/numbers/refs/heads/main/json-structure/numbers-fact-structure.json",
  "name": "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."
    },
    "number": {
      "type": "double",
      "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)."
    },
    "found": {
      "type": "boolean",
      "description": "Whether a real fact was found for the requested number."
    },
    "type": {
      "type": "string",
      "description": "Category of the returned fact.",
      "enum": ["trivia", "math", "date", "year"]
    },
    "date": {
      "type": "string",
      "description": "Day of year associated with year facts, as a string (e.g. `June 6`)."
    },
    "year": {
      "type": "string",
      "description": "Year associated with date facts, as a string (e.g. `1969`)."
    }
  }
}