The code in this repo moved
December 8, 2025 · View on GitHub
The code in this repo moved
The latest source code of JokeAPI lives on my own Git server for now: https://git.sv443.net/sv443/JokeAPI-v2
If you have any issues, please still use this repository on GitHub to submit them.
JokeAPI
> Documentation • Try it out • Changelog • Discord Server <
A free and open REST API that delivers consistently formatted jokes in JSON, XML, YAML, or plain text.
Powerful filters allow you to get just the jokes you want - no sign-up needed. Comes with CORS support.
Warning
JokeAPI contains a very wide variety of jokes, some of which can be seen as quite offensive.
They can be reliably filtered out using the parameters ?blacklistFlags and ?safe-mode.
Still, use this API at your own risk!
Note
JokeAPI is free to use, so it relies on donations to cover the costs.
If you enjoy using it, please consider supporting the development ❤️
Note
If you want to contribute to JokeAPI (code, jokes or translations), please refer to the contributing guide.
Also make sure to use the repo at https://git.sv443.net/sv443/JokeAPI-v2
Community-made wrapper libraries:
C#
Dart
Go
Java (com.github.the-codeboy.Jokes4J)- Java (com.simtechdata.jokeapi)
Kotlin, Java & Android (net.thauvin.erik.jokeapi)- Java (uz.khurozov.jokeapi-java)
Node.js
Odin
PHP
Python
Rust
TypeScript
Some projects that use JokeAPI:
Made with ❤️ by Sv443 and contributors
Like JokeAPI? Please consider supporting the development