Jokes API

API for fetching jokes : humorous content and punchlines

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"
}