Numbers API Random API
The Random API from Numbers API — 4 operation(s) for random.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/numbers-api-random-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Numbers Date Random API
description: 'Free REST API providing interesting mathematical facts, trivia, dates, and year facts about numbers for educational and fun applications. Returns short, readable facts about any number or date across four categories: trivia, mathematical properties, notable years, and day-of-year historical events. No authentication or API key required.
'
version: 1.0.0
contact:
url: http://numbersapi.com
license:
name: MIT
servers:
- url: http://numbersapi.com
description: Numbers API production server
tags:
- name: Random
paths:
/random/trivia:
get:
operationId: getRandomTriviaFact
summary: Get a random trivia fact
description: Returns an interesting trivia fact about a randomly selected number.
parameters:
- $ref: '#/components/parameters/json'
- $ref: '#/components/parameters/fragment'
- $ref: '#/components/parameters/notfound'
- $ref: '#/components/parameters/default'
- $ref: '#/components/parameters/min'
- $ref: '#/components/parameters/max'
- $ref: '#/components/parameters/callback'
responses:
'200':
description: A trivia fact about a random number (plain text or JSON)
content:
text/plain:
schema:
type: string
application/json:
schema:
$ref: '#/components/schemas/NumberFact'
tags:
- Random
/random/math:
get:
operationId: getRandomMathFact
summary: Get a random mathematical fact
description: Returns an interesting mathematical fact about a randomly selected number.
parameters:
- $ref: '#/components/parameters/json'
- $ref: '#/components/parameters/fragment'
- $ref: '#/components/parameters/notfound'
- $ref: '#/components/parameters/default'
- $ref: '#/components/parameters/min'
- $ref: '#/components/parameters/max'
- $ref: '#/components/parameters/callback'
responses:
'200':
description: A math fact about a random number (plain text or JSON)
content:
text/plain:
schema:
type: string
application/json:
schema:
$ref: '#/components/schemas/NumberFact'
tags:
- Random
/random/year:
get:
operationId: getRandomYearFact
summary: Get a random year fact
description: Returns an interesting fact about a randomly selected year.
parameters:
- $ref: '#/components/parameters/json'
- $ref: '#/components/parameters/fragment'
- $ref: '#/components/parameters/notfound'
- $ref: '#/components/parameters/default'
- $ref: '#/components/parameters/min'
- $ref: '#/components/parameters/max'
- $ref: '#/components/parameters/callback'
responses:
'200':
description: A year fact about a random year (plain text or JSON)
content:
text/plain:
schema:
type: string
application/json:
schema:
$ref: '#/components/schemas/YearFact'
tags:
- Random
/random/date:
get:
operationId: getRandomDateFact
summary: Get a random date fact
description: Returns an interesting historical fact about a randomly selected date.
parameters:
- $ref: '#/components/parameters/json'
- $ref: '#/components/parameters/fragment'
- $ref: '#/components/parameters/notfound'
- $ref: '#/components/parameters/default'
- $ref: '#/components/parameters/callback'
responses:
'200':
description: A date fact about a random date (plain text or JSON)
content:
text/plain:
schema:
type: string
application/json:
schema:
$ref: '#/components/schemas/DateFact'
tags:
- Random
components:
parameters:
max:
name: max
in: query
required: false
description: 'Maximum value for random number generation. Used with `random` number to constrain the range.
'
schema:
type: integer
json:
name: json
in: query
required: false
description: 'Return the fact and associated metadata as a JSON object instead of plain text. Can also be triggered by setting the Accept or Content-Type header to application/json.
'
schema:
type: boolean
fragment:
name: fragment
in: query
required: false
description: 'Return the fact as a sentence fragment that can be easily included as part of a larger sentence. The first word is lowercase and ending punctuation is omitted.
'
schema:
type: boolean
callback:
name: callback
in: query
required: false
description: '(Deprecated) JSONP callback function name. The response will be wrapped in a call to this function.
'
schema:
type: string
deprecated: true
min:
name: min
in: query
required: false
description: 'Minimum value for random number generation. Used with `random` number to constrain the range.
'
schema:
type: integer
notfound:
name: notfound
in: query
required: false
description: 'What to do if the number is not found. Options: `default` (return a pre-written missing message), `floor` (round down to the largest number with a fact), `ceil` (round up to the smallest number with a fact).
'
schema:
type: string
enum:
- default
- floor
- ceil
default: default
default:
name: default
in: query
required: false
description: 'A custom message to return if no fact is found for the requested number. Used in conjunction with `notfound=default`.
'
schema:
type: string
schemas:
YearFact:
type: object
description: A fact about a year with associated metadata
required:
- text
- found
- number
- type
properties:
text:
type: string
description: The fact text itself
example: 2012 is the year that the century's second and last solar transit of Venus occurs on June 6.
found:
type: boolean
description: Whether a fact was found for the requested year
example: true
number:
type: number
description: The year that the fact pertains to
example: 2012
type:
type: string
description: The category of the returned fact
example: year
date:
type: string
description: A day of year associated with some year facts
example: June 6
DateFact:
type: object
description: A fact about a calendar date with associated metadata
required:
- text
- found
- number
- type
properties:
text:
type: string
description: The fact text itself
example: February 29 is the day in 1504 that Christopher Columbus uses his knowledge of a lunar eclipse to convince Native Americans to provide him with supplies.
found:
type: boolean
description: Whether a fact was found for the requested date
example: true
number:
type: number
description: 'The 1-indexed day of a leap year (e.g., 61 would be March 1st)
'
example: 60
type:
type: string
description: The category of the returned fact
example: date
year:
type: string
description: A year associated with some date facts
example: '1504'
NumberFact:
type: object
description: A fact about a number with associated metadata
required:
- text
- found
- number
- type
properties:
text:
type: string
description: The fact text itself
example: 42 is the result given by Google and Bing for the query "the answer to life the universe and everything".
found:
type: boolean
description: Whether a fact was found for the requested number
example: true
number:
type: number
description: The number that the fact pertains to
example: 42
type:
type: string
description: The category of the returned fact
enum:
- trivia
- math
- year
- date
example: trivia