THE VERY SHORT MANUAL, EXPANDED

API documentation

Small endpoints. Complete instructions. Every API is a GET request with no signup or API key.

120 requests per minute per IP, with up to 30 per 10 seconds. Delay endpoints also allow only 20 per minute. Rate limits and retry guidance.

Utility

IP Address API

/ip

Find the public IP address of the client making the request.

UUID Generator API

/uuid

Generate a random version 4 UUID as JSON or plain text.

Current Time API

/time

Get the current time in UTC or a named IANA time zone.

Unix Timestamp API

/timestamp

Get the current Unix timestamp in whole seconds.

User Agent API

/user-agent

Read the User-Agent header sent with your HTTP request.

API Health Check

/health

Check whether the Dumb APIs Worker can respond.

Random

Coin Flip API

/coin

Flip a virtual coin and receive heads or tails as JSON.

Dice Roll API

/dice

Roll a six-sided die with a simple HTTP GET request.

Random Color API

/color

Get a random RGB hex color from a public HTTP endpoint.

Custom Dice API

/dice/:sides

Roll dice with a configurable number of sides.

Random Number API

/number

Generate a random integer within inclusive minimum and maximum bounds.

Random Boolean API

/boolean

Return a random true or false value as JSON.

Random Emoji API

/emoji

Get a random emoji from the bundled Unicode collection.

Random Playing Card API

/card

Draw a random rank and suit from a standard 52-card deck.

Random Picker API

/pick

Choose a random item from a comma-separated list.

Content

Random Joke API

/joke

Fetch a random joke as JSON without an API key.

Dad Joke API

/dad-joke

Fetch a random dad joke with no signup or API key.

Random Quote API

/quote

Get a real quote and its author from public-domain books.

Random Fact API

/fact

Fetch a short fact about nature, space, history, and more.

Fortune Cookie API

/fortune

Get a random fortune-cookie-style message.

Random Compliment API

/compliment

Fetch a short, friendly compliment with a GET request.

Random Excuse API

/excuse

Get a lighthearted excuse for everyday mishaps.

Would You Rather API

/would-you-rather

Fetch a would-you-rather question with two choices.

Decisions

Yes or No API

/yes-no

Get a random yes or no answer with one GET request.

Should I API

/should-i

Get a random answer to an optional question.

Magic 8 Ball API

/magic-8-ball

Get a random answer in the style of a magic eight ball.

Rock Paper Scissors API

/rps

Choose rock, paper, or scissors at random.

Calendar

Is It Friday API

/is-friday

Check whether the current UTC day is Friday.

Is It the Weekend API

/is-weekend

Check whether it is Saturday or Sunday in UTC.

Day of the Week API

/day-of-week

Get the English name of the current UTC weekday.

Day of the Year API

/day-of-year

Get today’s ordinal day number in the UTC calendar year.

ISO Week Number API

/week-number

Get the current ISO week number and week-numbering year.

Days Until Friday API

/days-until-friday

Count UTC calendar days until the next Friday.

Leap Year API

/leap-year

Check whether a given year is a Gregorian leap year.

Daily

Quote of the Day API

/daily/quote

Get one attributed quote shared across the current UTC day.

Joke of the Day API

/daily/joke

Get a joke shared by everyone for the current UTC day.

Fact of the Day API

/daily/fact

Get one fact selected for the current UTC day.

Fortune of the Day API

/daily/fortune

Get a fortune-cookie-style message for the current UTC day.

Color of the Day API

/daily/color

Get a deterministic RGB hex color for the current UTC day.

Emoji of the Day API

/daily/emoji

Get one emoji shared across the current UTC day.

HTTP

HTTP Status Code API

/status/:code

Request a supported HTTP status code for client testing.

HTTP Delay API

/delay/:seconds

Delay an HTTP response by a chosen number of seconds.

Request Headers API

/headers

Inspect a safe subset of the headers in your request.

HTTP Echo API

/echo

Echo your GET query parameters and selected request headers.