Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

JokeAPI Jokes API

Operations for retrieving and submitting jokes.

JokeAPI Jokes API is one of 3 APIs that JokeAPI publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Jokes. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and a changelog.

This API exposes 2 operations across 2 paths, and defines 7 schemas. It is described by OpenAPI 3.0.3, at version 2.3.3.

Requests are made against 2 base URLs: https://v2.jokeapi.dev, https://sv443.net/jokeapi/v2.

2 operations 2 paths 7 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.3.3
Base URL
https://v2.jokeapi.dev
Contact
License
Resource Areas
1

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 1 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Jokes 2

Operations for retrieving and submitting jokes.

GET
/joke/{category}
JokeAPI Get Joke by Category
getJoke 9 params → 200400404429
POST
/submit
JokeAPI Submit Joke
submitJoke 2 params body → 201400429

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are TwopartJoke (9 properties), SingleJoke (8 properties), JokeSubmission (8 properties), JokeError (7 properties). Each schema is shown below with its type and property counts.

JokeFlags
object
Content classification flags carried on every joke.
6 properties 6 required
TwopartJoke
object
A joke delivered as a setup/delivery pair.
9 properties 9 required
JokeSubmission
object
Submission payload for POST /submit.
8 properties 5 required
JokeError
object
Error envelope returned for any failed request.
7 properties 5 required
SingleJoke
object
A joke delivered as one line of text.
8 properties 8 required
SubmissionResponse
object
Submission response envelope.
4 properties 3 required
JokeBatch
object
Envelope returned when ?amount is greater than 1.
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

jokeapi-jokes-api-openapi.yml Raw ↑

Other APIs JokeAPI publishes across the network.

JokeAPI Metadata API
JokeAPI System API