# 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
    }
}
```


---

# 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://docs.night-api.com/joke/jokes.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.