API Docs

Documentation for the Truth or Dare API.

The base API URL for all endpoints is https://api.truthordarebot.xyz/v1/

The global rate limit for all API requests is 5/5s

Get Truth

GET 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.

200

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

Get Dare

GET 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.

200

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

Get Would You Rather

GET 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.

200

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

Get Never Have I Ever

GET 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.

200

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

Get Paranoia Question

GET 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.

200

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