---
title: "GET /joke/random"
method: GET
path: "/joke/random"
tags: ["joke"]
---

# GET /joke/random

`GET /joke/random`

Gets a `Random Joke`. When you are in a hurry this is what you call to get a random famous joke.

## Response `200`

200  response

- JokeResponse
  - `success` string — Metadata about this successful call
  - `contents` object
    - `jokes` Joke[] — List of jokes
      - `author` string — Author name of joke.
      - `title` string, required — Title of the Joke.
      - `joke` string, required — The Joke.
      - `tags` string[] — Array of tags/categories.
      - `id` string — Unique identifier representing a specific joke in jokes.one.
      - `image` string — Image URL that can be used for background to display this joke.
      - `length` integer — Length of the joke string.

## Other responses

- `401` — 401 response

---

[API](https://skmtc.net/jokes/apis/jokes-one-api.md) · [All operations](https://skmtc.net/jokes/apis/jokes-one-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jokes/jokes-one-api/versions/fb8b9f02758b/schema)