All of our API responses are structured in the same way, providing consistency across endpoints. The following fields are included:
An HTTP status code indicating the result of the request.
A brief, human-readable message indicating the result of the request.
The requested information. This field is not always provided depending on the endpoint and request.
{
"code": 200,
"message": "Bot statistics were fetched successfully.",
"data": {
"links": 37975,
"users": 777906,
"guilds": 10403,
"version": "v1.6.0 Stable"
}
}
Some more error responses can be found below as a reference.
{
"code": 400,
"message": "An invalid ID was provided."
}
{
"code": 401,
"message": "Header 'Token' was not provided."
}
{
"code": 403,
"message": "You are blacklisted from Ducky."
}
{
"code": 405,
"message": "Method POST is not supported on endpoint /statistics."
}
{
"code": 429,
"message": "Too many requests, please try again later."
}
For more information regarding ratelimiting, please refer to the Ratelimits page. 500 Internal Server Error
{
"code": 500,
"message": "An internal error occurred while processing this request. Please try again later."
}