> For the complete documentation index, see [llms.txt](https://tutyamxx.gitbook.io/romanian-jokes-api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tutyamxx.gitbook.io/romanian-jokes-api-docs/get-a-random-joke-within-specific-category.md).

# GET -  A Random Joke Within Specific Category

➡️ This will be the endpoint in retrieving a random Romanian joke filtered by a specific category

## Get a random Romanian joke filtered by a specific category

<mark style="color:blue;">`GET`</mark> `https://romanian-jokes-api.herokuapp.com/v1/romanianjokes/filter/:joketype/random`

This endpoint allows you to get a random Romanian joke filtered by a specific category

#### Path Parameters

| Name           | Type   | Description                      |
| -------------- | ------ | -------------------------------- |
| /romanianjokes | string | Obligatory path                  |
| /filter        | string | Path towards the joke filtering  |
| /random        | string | Path towards the random function |

#### Query Parameters

| Name     | Type   | Description                       |
| -------- | ------ | --------------------------------- |
| joketype | string | A specific existing joke category |

{% tabs %}
{% tab title="200 Random Romanian joke from seci category successfully retrieved." %}

```
{
    "id": 110,
    "joketype": "seci",
    "joke": "Doi scheleți se trag de piele!"
}
```

{% endtab %}

{% tab title="404 Could not find the mentioned specific category matching this query." %}

```
{
    "message": "This joke type could not be found in the jokes list"
}
```

{% endtab %}
{% endtabs %}