# 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**](https://docs.night-api.com/joke/jokes/aleatoire): You can only choose which category of joke you do not want to have

{% content-ref url="jokes/aleatoire" %}
[aleatoire](https://docs.night-api.com/joke/jokes/aleatoire)
{% endcontent-ref %}

* [**Jokes by category**](https://docs.night-api.com/joke/jokes/type): You will receive only the jokes of which you indicated the category&#x20;

{% content-ref url="jokes/type" %}
[type](https://docs.night-api.com/joke/jokes/type)
{% endcontent-ref %}

* [**Jokes by ID**](https://docs.night-api.com/joke/jokes/id): You will receive the jokes of which you indicate the ID

{% content-ref url="jokes/id" %}
[id](https://docs.night-api.com/joke/jokes/id)
{% 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
    }
}
```