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

# API Docs

{% hint style="info" %}
The base API URL for all endpoints is <https://api.truthordarebot.xyz/v1/>
{% endhint %}

{% hint style="warning" %}
The global rate limit for all API requests is 5/5s
{% endhint %}

## Get Truth

<mark style="color:blue;">`GET`</mark> `https://api.truthordarebot.xyz/v1/truth`

This endpoint returns a truth question. R rating is disabled by default unless you specify it in the rating query.

#### Query Parameters

| Name   | Type   | Description                                                                                                              |
| ------ | ------ | ------------------------------------------------------------------------------------------------------------------------ |
| rating | string | The rating of the question. Must be "pg", "pg13" or "r". You can use this query multiple times to get different ratings. |

{% tabs %}
{% tab title="200 " %}

```
{
  "id": "ku9abgpj6u59",
  "type": "TRUTH",
  "rating": "PG13",
  "question": "Would you break up with someone over text?"
}
```

{% endtab %}
{% endtabs %}

## Get Dare

<mark style="color:blue;">`GET`</mark> `https://api.truthordarebot.xyz/api/dare`

This endpoint returns a dare question. R rating is disabled by default unless you specify it in the rating query.

#### Query Parameters

| Name   | Type   | Description                                                                                                              |
| ------ | ------ | ------------------------------------------------------------------------------------------------------------------------ |
| rating | string | The rating of the question. Must be "pg", "pg13" or "r". You can use this query multiple times to get different ratings. |

{% tabs %}
{% tab title="200 " %}

```
{
  "id": "ku9abgpjs933",
  "type": "DARE",
  "rating": "PG13",
  "question": "Rate everyone here 1-10 in terms of looks."
}
```

{% endtab %}
{% endtabs %}

## Get Would You Rather

<mark style="color:blue;">`GET`</mark> `https://api.truthordarebot.xyz/api/wyr`

This endpoint returns a would you rather question. R rating is disabled by default unless you specify it in the rating query.

#### Path Parameters

| Name   | Type   | Description                                                                                                              |
| ------ | ------ | ------------------------------------------------------------------------------------------------------------------------ |
| rating | string | The rating of the question. Must be "pg", "pg13" or "r". You can use this query multiple times to get different ratings. |

{% tabs %}
{% tab title="200 " %}

```
{
  "id": "ku9abgpkd2mo",
  "type": "WYR",
  "rating": "PG13",
  "question": "Would you rather be unhappily single OR unhappily married?"
}
```

{% endtab %}
{% endtabs %}

## Get Never Have I Ever

<mark style="color:blue;">`GET`</mark> `https://api.truthordarebot.xyz/api/nhie`

This endpoint returns a would you rather question. R rating is disabled by default unless you specify it in the rating query.

#### Path Parameters

| Name   | Type   | Description                                                                                                              |
| ------ | ------ | ------------------------------------------------------------------------------------------------------------------------ |
| rating | string | The rating of the question. Must be "pg", "pg13" or "r". You can use this query multiple times to get different ratings. |

{% tabs %}
{% tab title="200 " %}

```
{
  "id": "ku9abgpk74r5",
  "type": "NHIE",
  "rating": "PG13",
  "question": "Never have I ever dated someone in this server."
}
```

{% endtab %}
{% endtabs %}

## Get Paranoia Question

<mark style="color:blue;">`GET`</mark> `https://api.truthordarebot.xyz/api/paranoia`

This endpoint returns a paranoia question. R rating is disabled by default unless you specify it in the rating query.

#### Path Parameters

| Name   | Type   | Description                                                                                                              |
| ------ | ------ | ------------------------------------------------------------------------------------------------------------------------ |
| rating | string | The rating of the question. Must be "pg", "pg13" or "r". You can use this query multiple times to get different ratings. |

{% tabs %}
{% tab title="200 " %}

```
{
  "id": "ku9abgpk00fs",
  "type": "PARANOIA",
  "rating": "PG13",
  "question": "Who's most likely to move to stay with a partner?"
}
```

{% endtab %}
{% endtabs %}