JokeAPI · Schema

SingleJoke

A joke delivered as one line of text.

JokesHumorEntertainmentOpen SourceREST APIGames And ComicsPublic APIs

Properties

Name Type Description
error boolean Always false on a successful joke response.
category string Category the joke belongs to.
type string Joke shape — always `single` for this schema.
joke string The joke text.
flags object Content classification flags carried on every joke.
id integer Joke identifier within its language scope.
safe boolean True when the joke has no flags and is not Dark.
lang string ISO 639-1 language code of the joke.
View JSON Schema on GitHub

JSON Schema

jokeapi-single-joke-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/jokeapi/refs/heads/main/json-schema/jokeapi-single-joke-schema.json",
  "title": "SingleJoke",
  "description": "A joke delivered as one line of text.",
  "type": "object",
  "properties": {
    "error": {
      "type": "boolean",
      "description": "Always false on a successful joke response.",
      "example": false
    },
    "category": {
      "type": "string",
      "description": "Category the joke belongs to.",
      "enum": [
        "Misc",
        "Programming",
        "Dark",
        "Pun",
        "Spooky",
        "Christmas"
      ],
      "example": "Programming"
    },
    "type": {
      "type": "string",
      "description": "Joke shape \u2014 always `single` for this schema.",
      "enum": [
        "single"
      ],
      "example": "single"
    },
    "joke": {
      "type": "string",
      "description": "The joke text.",
      "example": "Why do programmers prefer dark mode? Because light attracts bugs."
    },
    "flags": {
      "type": "object",
      "description": "Content classification flags carried on every joke.",
      "properties": {
        "nsfw": {
          "type": "boolean",
          "description": "Joke contains adult or explicit sexual content.",
          "example": false
        },
        "religious": {
          "type": "boolean",
          "description": "Joke references or mocks religion.",
          "example": false
        },
        "political": {
          "type": "boolean",
          "description": "Joke references politics or political figures.",
          "example": false
        },
        "racist": {
          "type": "boolean",
          "description": "Joke contains racist content.",
          "example": false
        },
        "sexist": {
          "type": "boolean",
          "description": "Joke contains sexist content.",
          "example": false
        },
        "explicit": {
          "type": "boolean",
          "description": "Joke contains explicit language unrelated to NSFW.",
          "example": false
        }
      },
      "required": [
        "nsfw",
        "religious",
        "political",
        "racist",
        "sexist",
        "explicit"
      ]
    },
    "id": {
      "type": "integer",
      "description": "Joke identifier within its language scope.",
      "example": 42
    },
    "safe": {
      "type": "boolean",
      "description": "True when the joke has no flags and is not Dark.",
      "example": true
    },
    "lang": {
      "type": "string",
      "description": "ISO 639-1 language code of the joke.",
      "example": "en"
    }
  },
  "required": [
    "error",
    "category",
    "type",
    "joke",
    "flags",
    "id",
    "safe",
    "lang"
  ]
}