JokeAPI · JSON Structure

Jokeapi Info Response Structure

Runtime info envelope describing JokeAPI's current state.

Type: object Properties: 8 Required: 5

JokesHumorEntertainmentOpen SourceREST APIGames And ComicsPublic APIs

InfoResponse is a JSON Structure definition published by JokeAPI, describing 8 properties, of which 5 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

error version jokes formats jokeLanguages systemLanguages info timestamp

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/jokeapi/refs/heads/main/json-structure/jokeapi-info-response-structure.json",
  "name": "InfoResponse",
  "description": "Runtime info envelope describing JokeAPI's current state.",
  "type": "object",
  "properties": {
    "error": {
      "type": "boolean",
      "example": false
    },
    "version": {
      "type": "string",
      "description": "Running JokeAPI version.",
      "example": "2.3.3"
    },
    "jokes": {
      "type": "object",
      "description": "Joke catalogue snapshot.",
      "properties": {
        "totalCount": {
          "type": "int32",
          "example": 1368
        },
        "categories": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "example": [
            "Any",
            "Misc",
            "Programming",
            "Dark",
            "Pun",
            "Spooky",
            "Christmas"
          ]
        },
        "flags": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "example": [
            "nsfw",
            "religious",
            "political",
            "racist",
            "sexist",
            "explicit"
          ]
        },
        "types": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "example": [
            "single",
            "twopart"
          ]
        },
        "submissionURL": {
          "type": "string",
          "example": "https://v2.jokeapi.dev#submit"
        },
        "idRange": {
          "type": "object",
          "description": "Per-language ID range pair `[min, max]`.",
          "additionalProperties": {
            "type": "array",
            "items": {
              "type": "integer"
            },
            "minItems": 2,
            "maxItems": 2
          }
        },
        "safeJokes": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "lang": {
                "type": "string"
              },
              "count": {
                "type": "int32"
              }
            }
          }
        }
      }
    },
    "formats": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "example": [
        "json",
        "xml",
        "yaml",
        "txt"
      ]
    },
    "jokeLanguages": {
      "type": "int32",
      "example": 6
    },
    "systemLanguages": {
      "type": "int32",
      "example": 5
    },
    "info": {
      "type": "string",
      "example": "If you want to stay up to date on the status and future updates of JokeAPI..."
    },
    "timestamp": {
      "type": "int32",
      "example": 1780051223357
    }
  },
  "required": [
    "error",
    "version",
    "jokes",
    "formats",
    "timestamp"
  ]
}