aid: joke-api
name: JokeAPI
description: JokeAPI is a free, open-source REST API that delivers consistently formatted jokes with no authentication, registration, or payment required. It provides over 1,368 jokes across categories including Programming, Misc, Dark, Pun, Spooky, and Christmas in 6 languages. The API supports rich filtering by category, language, content flags (NSFW, Religious, Political, Racist, Sexist, Explicit), and joke type (single or two-part). Response formats include JSON, XML, YAML, and plain text. A safe mode ensures family-friendly content for appropriate applications.
image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
url: https://raw.githubusercontent.com/api-evangelist/joke-api/refs/heads/main/apis.yml
created: '2026-06-13'
modified: '2026-06-13'
specificationVersion: '0.19'
tags:
  - Jokes
  - Humor
  - Entertainment
  - Programming Jokes
  - Dark Humor
  - Puns
  - Free API
  - Open Source
apis:
  - aid: joke-api:joke-api
    name: JokeAPI
    description: A REST API delivering consistently formatted jokes with filtering by category, language, content flags, and joke type. Supports multiple response formats and requires no authentication.
    image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
    humanURL: https://jokeapi.dev/
    baseURL: https://v2.jokeapi.dev
    tags:
      - Jokes
      - Humor
      - Entertainment
      - Programming
      - Dark Humor
      - Puns
    properties:
      - type: Documentation
        url: https://jokeapi.dev/
      - type: OpenAPI
        url: https://raw.githubusercontent.com/Sv443-Network/JokeAPI/master/openapi.json
      - type: GitHubOrg
        url: https://github.com/Sv443-Network
      - type: GitHubRepository
        url: https://github.com/Sv443-Network/JokeAPI
      - type: StatusPage
        url: https://status.sv443.net/
      - type: Changelog
        url: https://github.com/Sv443-Network/JokeAPI/blob/master/changelog.md
      - type: Discord
        url: https://sv443.net/discord
      - type: Plans
        url: plans/joke-api-plans-pricing.yml
      - type: RateLimits
        url: rate-limits/joke-api-rate-limits.yml
      - type: FinOps
        url: finops/joke-api-finops.yml
common:
  - type: Website
    url: https://jokeapi.dev/
  - type: Documentation
    url: https://jokeapi.dev/
  - type: GitHubOrg
    url: https://github.com/Sv443-Network
  - type: StatusPage
    url: https://status.sv443.net/
  - type: Plans
    url: plans/joke-api-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/joke-api-rate-limits.yml
  - type: FinOps
    url: finops/joke-api-finops.yml
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com