> For the complete documentation index, see [llms.txt](https://docs.night-api.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.night-api.com/joke/jokes.md).

# Jokes

{% hint style="danger" %}
This API requires an API key to be sent along with your requests: Get yours by <mark style="color:red;">creating an account</mark>
{% endhint %}

{% hint style="info" %}
All jokes are **only available in french** for the moment. Sorry for the inconvenience.

We are hard working for create a translation
{% endhint %}

Different methods exist to have jokes, currently there are three and here they are:

* [**Random Jokes**](/joke/jokes/aleatoire.md): You can only choose which category of joke you do not want to have

{% content-ref url="/pages/-Ma9x56yjcAKtISmvsb0" %}
[Random](/joke/jokes/aleatoire.md)
{% endcontent-ref %}

* [**Jokes by category**](/joke/jokes/type.md): You will receive only the jokes of which you indicated the category&#x20;

{% content-ref url="/pages/-Ma52t\_1YosQ6XLTtNpK" %}
[Category](/joke/jokes/type.md)
{% endcontent-ref %}

* [**Jokes by ID**](/joke/jokes/id.md): You will receive the jokes of which you indicate the ID

{% content-ref url="/pages/-Ma9x5mT\_A22oBAG1WTM" %}
[ID](/joke/jokes/id.md)
{% endcontent-ref %}

Here is an example of what each method returns

```json
{
    "status": 200, //The status allows to know if the joke was found or not 
    "content": {
        "id": 44, // The unique identifier
        "type": "global", // The category of the joke
        "blague": "Que dit un canard quand il va aux toilettes ?", // The joke
        "reponse": "Je vais au petit coin." // The answer
    }
}
```