---
title: "searches jokes"
method: GET
path: "/joke"
tags: ["developers"]
---

# searches jokes

`GET /joke`

By passing in the appropriate options, you can search for
available jokes

## Query parameters

- `searchString` string
- `numberofJokes` integer
- `category` string
- `sortBy` string
- `sortOrder` string

## Response `200`

search results matching criteria

- Joke[]
  - `id` string, required — The id of the Joke. Assigned when added.
  - `joke` string, required — The lead-in to the joke.
  - `punchline` string, required — This bit should make you laugh :).
  - `category` string, required — the category of the joke.
  - `thumbsUp` integer, required — Count of upvotes for the joke.
  - `thumbsDown` integer, required — Count of down votes for the joke.
  - `dateAdded` string, date-time, required

## Other responses

- `400` — bad input parameter

---

[API](https://skmtc.dev/swaggerhub/apis/simple-joke-api.md) · [All operations](https://skmtc.dev/swaggerhub/apis/simple-joke-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/swaggerhub/simple-joke-api/revisions/2b4983465623/schema)