# Jokes API

**Jokes API Documentation**

A jokes API is like a library of jokes you can access online. It lets you easily get funny stories for your website, chatbot, game, or any project you want to add a bit of humor to. Think of it as a fun and easy way to get laugh!

**Basic URL**

```
https://santechapi.vercel.app
```

### Authentication

```
headers : {
"token" : {YOUR API KEY}
}
```

**Endpoint:** `/Jokes/`

*HTTP Method: Get*

**Example request**

```
/Jokes/
```

Example Response

```
[
	{
		"_id": "65452b1c01731ce2e4afd56a",
		"type": "general",
		"setup": "What did the 0 say to the 8?",
		"punchline": "Nice belt.",
		"id": 167
	},
	{
		"_id": "65452b1c01731ce2e4afd56b",
		"type": "general",
		"setup": "Why do bees have sticky hair?",
		"punchline": "Because they use honey combs!",
		"id": 348
	},
	{
		"_id": "65452b1c01731ce2e4afd56c",
		"type": "general",
		"setup": "What do you call a fat psychic?",
		"punchline": "A four-chin teller.",
		"id": 208
	},
	{
		"_id": "65452b1c01731ce2e4afd56d",
		"type": "general",
		"setup": "What do you call someone with no nose?",
		"punchline": "Nobody knows.",
		"id": 227
	},
	{
		"_id": "65452b1c01731ce2e4afd56e",
		"type": "general",
		"setup": "What did the Red light say to the Green light?",
		"punchline": "Don't look at me I'm changing!",
		"id": 184
	},
	{
		"_id": "65452b1c01731ce2e4afd56f",
		"type": "general",
		"setup": "What was the pumpkin’s favorite sport?",
		"punchline": "Squash.",
		"id": 268
	},
	{
		"_id": "65452b1c01731ce2e4afd570",
		"type": "general",
		"setup": "Why did the melons plan a big wedding?",
		"punchline": "Because they cantaloupe!",
		"id": 336
	},
	{
		"_id": "65452b1c01731ce2e4afd571",
		"type": "general",
		"setup": "Do you know where you can get chicken broth in bulk?",
		"punchline": "The stock market.",
		"id": 107
	},
	{
		"_id": "65452b1c01731ce2e4afd572",
		"type": "general",
		"setup": "What time is it?",
		"punchline": "I don't know... it keeps changing.",
		"id": 78
	},
	{
		"_id": "65452b1c01731ce2e4afd573",
		"type": "general",
		"setup": "What is a centipedes's favorite Beatle song?",
		"punchline": " I want to hold your hand, hand, hand, hand...",
		"id": 244
	},
	{
		"_id": "65452c918ee2173454d738f3",
		"id": 35,
		"type": "programming",
		"setup": "Why do Java programmers wear glasses?",
		"punchline": "Because they don't C#.",
		"createdAt": "2023-11-03T17:23:29.240Z",
		"updatedAt": "2023-11-03T17:23:29.240Z",
		"__v": 0
	},
	{
		"_id": "65452d7353178d28747a9708",
		"id": 388,
		"type": "programming",
		"setup": "What is the most used language in programming?",
		"punchline": "Profanity.",
		"createdAt": "2023-11-03T17:27:15.070Z",
		"updatedAt": "2023-11-03T17:27:15.070Z",
		"__v": 0
	}
]
```

### Error Handling

In case of an error, the API will respond with an appropriate HTTP status code and an error message in the response body.

```
 {
message: "Error retrieving the joke documents"
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://santech.gitbook.io/docs/jokes-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.