Connected accounts

Discord’s own user-profile endpoint turned into bio, pronouns, Nitro since, the pre-pomelo legacy username, mutual servers with our indexer, and every connected account (Steam, Spotify, YouTube, Twitch, GitHub, Reddit, PlayStation, Xbox, Battle.net, Riot, TikTok, …). A 200 or a 404 takes 1 search from your quota.

GET /v1/connections/{id}

Connections

cURL

curl --request GET \
  --url https://api.dis.dog/v1/connections/{id} \
  --header 'Authorization: Bearer <token>'

200

{
  "bio": "<string>",
  "pronouns": "<string>",
  "legacyUsername": "Nelly#0001",
  "bannerUrl": "<string>",
  "premiumType": 123,
  "premiumSince": "2023-11-07T05:31:56Z",
  "mutualGuilds": [
    {
      "id": "<string>",
      "nick": "<string>",
      "name": "<string>",
      "iconUrl": "<string>",
      "memberCount": 123
    }
  ],
  "connections": [
    {
      "type": "steam",
      "name": "<string>",
      "typeName": "Steam",
      "id": "<string>",
      "verified": true,
      "url": "<string>"
    }
  ]
}

Everything Discord’s public profile endpoint adds to the basic user object: bio, pronouns, Nitro since, pre-pomelo legacy username, mutual servers with our indexer, and every linked external account (Steam, Spotify, YouTube, Twitch, GitHub, Reddit, PlayStation, Xbox, Battle.net, Riot, TikTok, …). A 200 or a 404 takes 1 search from your quota.

The same object is in every search for a Discord ID, as data of the connections module. About the module →

Each Discord ID is cached up to 6 hours. Only accounts the user chose to make visible on their profile appear in connections.

Authorizations

Authorization · string · header · required

Your access key, DD-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX. The same key is your website login. Keep it server-side.

Path Parameters

id · string · required

A Discord ID (17 to 20 digits).

Pattern: ^\d{17,20}$

Example:

"80351110224678912"

Response

200

application/json

Connections

Only answers when a research account shares a server with the user; otherwise 404 not_available.

bio · string | null

pronouns · string | null

legacyUsername · string | null

Example:

"Nelly#0001"

bannerUrl · string | null

premiumType · integer | null

1 Classic, 2 Nitro, 3 Basic.

premiumSince · string<date-time> | null

mutualGuilds · object[]

Servers shared with our research accounts, biggest first.

Show child attributes

connections · object[]

Show child attributes