Fetch user guilds
curl --request GET \
--url https://api.duckybot.xyz/guilds \
--header 'Token: <token>'import requests
url = "https://api.duckybot.xyz/guilds"
headers = {"Token": "<token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Token: '<token>'}};
fetch('https://api.duckybot.xyz/guilds', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.duckybot.xyz/guilds",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Token: <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.duckybot.xyz/guilds"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Token", "<token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.duckybot.xyz/guilds")
.header("Token", "<token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.duckybot.xyz/guilds")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Token"] = '<token>'
response = http.request(request)
puts response.read_body{
"code": 200,
"message": "Guilds for '598958193032560642' fetched successfully.",
"data": [
{
"name": "đ Ducky's Pond",
"id": "1228508072289370172",
"icon": "https://cdn.discordapp.com/icons/1228508072289370172/78c23e643bd80241aa013b88cd0225cb.png",
"members": 1790,
"owner": "598958193032560642",
"role": "Owner",
"ducky": true,
"plus": {
"plus": {
"userid": "1257389588910182411",
"guilds": [
"1228508072289370172"
],
"slots": 0
},
"active": true
},
"permissions": {
"ERLC_STAFF": true,
"DUCKY_PLUS_GUILD": true,
"QUALITY_ASSURANCE": true,
"ERLC_ADMIN": true,
"DOCWRITER": true,
"FOUNDER": true,
"ERLC_MANAGER": true,
"MANAGE_SERVER": true,
"EXECUTIVE": true,
"BOT_DEVELOPER": true,
"WEB_DEVELOPER": true,
"SETUP": true,
"SESSION_STARTER": true,
"MOD": true,
"SUPPORT": true,
"MANAGEMENT": true,
"ADMIN": true,
"DUCKY_STAFF": true,
"ERLC_LINKED": true,
"DUCKY_PLUS_MEMBER": true
}
}
// ...
]
}
Data Endpoints
Fetch user guilds
Fetch all guilds a user is in that has Ducky.
GET
/
guilds
Fetch user guilds
curl --request GET \
--url https://api.duckybot.xyz/guilds \
--header 'Token: <token>'import requests
url = "https://api.duckybot.xyz/guilds"
headers = {"Token": "<token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Token: '<token>'}};
fetch('https://api.duckybot.xyz/guilds', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.duckybot.xyz/guilds",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Token: <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.duckybot.xyz/guilds"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Token", "<token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.duckybot.xyz/guilds")
.header("Token", "<token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.duckybot.xyz/guilds")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Token"] = '<token>'
response = http.request(request)
puts response.read_body{
"code": 200,
"message": "Guilds for '598958193032560642' fetched successfully.",
"data": [
{
"name": "đ Ducky's Pond",
"id": "1228508072289370172",
"icon": "https://cdn.discordapp.com/icons/1228508072289370172/78c23e643bd80241aa013b88cd0225cb.png",
"members": 1790,
"owner": "598958193032560642",
"role": "Owner",
"ducky": true,
"plus": {
"plus": {
"userid": "1257389588910182411",
"guilds": [
"1228508072289370172"
],
"slots": 0
},
"active": true
},
"permissions": {
"ERLC_STAFF": true,
"DUCKY_PLUS_GUILD": true,
"QUALITY_ASSURANCE": true,
"ERLC_ADMIN": true,
"DOCWRITER": true,
"FOUNDER": true,
"ERLC_MANAGER": true,
"MANAGE_SERVER": true,
"EXECUTIVE": true,
"BOT_DEVELOPER": true,
"WEB_DEVELOPER": true,
"SETUP": true,
"SESSION_STARTER": true,
"MOD": true,
"SUPPORT": true,
"MANAGEMENT": true,
"ADMIN": true,
"DUCKY_STAFF": true,
"ERLC_LINKED": true,
"DUCKY_PLUS_MEMBER": true
}
}
// ...
]
}
{
"code": 200,
"message": "Guilds for '598958193032560642' fetched successfully.",
"data": [
{
"name": "đ Ducky's Pond",
"id": "1228508072289370172",
"icon": "https://cdn.discordapp.com/icons/1228508072289370172/78c23e643bd80241aa013b88cd0225cb.png",
"members": 1790,
"owner": "598958193032560642",
"role": "Owner",
"ducky": true,
"plus": {
"plus": {
"userid": "1257389588910182411",
"guilds": [
"1228508072289370172"
],
"slots": 0
},
"active": true
},
"permissions": {
"ERLC_STAFF": true,
"DUCKY_PLUS_GUILD": true,
"QUALITY_ASSURANCE": true,
"ERLC_ADMIN": true,
"DOCWRITER": true,
"FOUNDER": true,
"ERLC_MANAGER": true,
"MANAGE_SERVER": true,
"EXECUTIVE": true,
"BOT_DEVELOPER": true,
"WEB_DEVELOPER": true,
"SETUP": true,
"SESSION_STARTER": true,
"MOD": true,
"SUPPORT": true,
"MANAGEMENT": true,
"ADMIN": true,
"DUCKY_STAFF": true,
"ERLC_LINKED": true,
"DUCKY_PLUS_MEMBER": true
}
}
// ...
]
}
Headers
string
required
The Ducky session token of the user.
Response Data
object[]
In this endpoint, the response data is an array of objects.
Show properties
Show properties
string
The guildâs name.
string
The guildâs ID.
string
The guildâs icon URL.
number
The guildâs membercount.
string
The guild ownerâs ID.
string
The memberâs role within the guild.Can either be
Owner, Manager, Administrator, or Moderator.boolean
deprecated
Whether or not Ducky is in the guild. As of v1.6.0 Stable, this is always
true and therefore will soon be deprecated.object
The guildâs Ducky Plus+ status.
âI