Joke

Returns a random joke. Powered by JokeAPIarrow-up-right.

GET /random/joke

Parameters

Parameter
Required
Default
Description

category

No

Any

Joke category (see below)

type

No

single

Joke format: single or twopart

Categories

Any, Programming, Misc, Dark, Pun, Spooky, Christmas

Example

Single joke:

curl "https://api.uwuapps.org/random/joke?category=Programming&type=single"

Response (single)

{
  "success": true,
  "category": "Programming",
  "type": "single",
  "joke": "Why do programmers prefer dark mode? Because light attracts bugs."
}

Two-part joke:

Response (twopart)

Notes

  • Jokes are filtered to exclude NSFW, religious, political, racist, sexist, and explicit content.

  • Returns 502 if JokeAPI is unreachable.

Last updated

Was this helpful?