> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dis.dog/llms.txt
> Use this file to discover all available pages before exploring further.

# Connected accounts

> Bio, pronouns, Nitro since, pre-pomelo legacy username, mutual servers, and every account linked on the Discord profile (Steam, Spotify, YouTube, Twitch, GitHub, Reddit, PlayStation, Xbox, Battle.net, Riot, TikTok, …).

> [!TIP]
>
> **Live.** Runs on every search for a Discord ID, and on its own with [`GET /v1/connections/{id}`](https://docs.dis.dog/api-reference/endpoints/connections).

The connections module answers everything the public profile page shows but the standard [profile](https://docs.dis.dog/modules/profile.md) module can’t: **bio, pronouns, Nitro since, pre-pomelo legacy username, mutual servers with DisDog’s indexer, and every linked external account** (Steam, Spotify, YouTube, Twitch, GitHub, Reddit, PlayStation, Xbox, Battle.net, Riot, TikTok, …).

## What it returns

| Field | What it is |
| - | - |
| `bio` | The “About me” text on the profile. `null` when it is empty. |
| `pronouns` | The pronouns the account set on its profile. |
| `legacyUsername` | The old `name#1234` username, kept by Discord after the account moved to pomelo. |
| `bannerUrl`, `accentColor` | The profile’s banner image (when set) and the accent colour behind the username. |
| `premiumType` | `0` none, `1` Classic, `2` Nitro, `3` Basic. |
| `premiumSince`, `premiumGuildSince` | When Nitro and server boosting started, as ISO dates. |
| `mutualGuilds` | Servers DisDog’s own indexer shares with this account. The set grows as the indexer joins more servers. |
| `connections` | Every connected account on the profile, with `type`, `name`, `id`, `typeName`, `verified`, `revoked`, a public `url` when the platform exposes one, and `metadata` published for that connection. |
| `profileBadges` | Profile badges Discord returns on the profile endpoint (verification, moderator alumni, boost tiers…). |
| `connections[].details` | The account looked up on its own platform (see below): `displayName`, `handle`, `avatarUrl`, `bannerUrl`, `bio`, `createdAt`, `verified`, `live` (Twitch), `stats`, `facts`, `links` (other accounts the platform profile points to, each with its `type` and `handle`; links to accounts that don’t exist are left out), and `items` (games, videos, repositories, posts…). `null` when the platform has no public source. |
| `foundAccounts` | Accounts the connected profiles link to in turn, kept only when the account exists (a TikTok or an Instagram on their Twitch channel…), with `type`, `name`, `url`, `via` (the platform it was found on) and the same `details`. |

## Platform lookups

Each connected account is followed up on its own platform:

| Platform | What `details` holds |
| - | - |
| Twitch | Followers, partner / affiliate, live now (title, game, viewers), last stream, recent broadcasts, the channel’s social links. |
| Xbox | Gamerpic, Gamerscore, followers, account tier, tenure, and game history with achievement progress. |
| X | The account itself: followers, following, post and like counts, media count, join date, location, website and account type. The posts themselves are not read. |
| Steam | Persona, real name and location (when set), member since, VAC and trade bans, status, most played games or groups. |
| GitHub | Followers, repositories, company, location, public e-mail, website, latest repositories. |
| YouTube | Subscribers, video count, handle, latest videos. |
| TikTok | Followers, following, likes, videos, join date, bio link. |
| Bluesky | Followers, following, posts, latest posts. |
| SoundCloud | Followers, tracks, likes, full name, city. |
| Roblox | Friends, followers, groups, previous names, linked socials. |
| Kick | Followers, verified, live now (title, category, viewers), what they stream, linked socials. |
| Domain | Registrar, registration and expiry dates, status, name servers. |

Epic Games, Spotify, Reddit, Instagram, PlayStation, Battle.net and Riot accounts are listed with their name and link, without `details`.

## How to run it

On its own, for one ID:

```bash theme={"system"}
curl "https://api.dis.dog/v1/connections/123456789012345678" \
  -H "Authorization: Bearer $DISDOG_KEY"
```

Or as part of a [search](https://docs.dis.dog/api-reference/endpoints/search.md): the `connections` entry of `modules` has `"status": "found"` and the same object in `data`.

## Good to know

* The source is Discord’s own `/users/{id}/profile` endpoint, read with a dedicated account. Each ID is cached up to **6 hours**.
* Only accounts the user chose to make **visible** on their profile appear in `connections`; private connections are hidden by Discord itself.
* `mutualGuilds` is relative to DisDog’s indexer. An empty list does not mean the account is in no server, only that it shares none with ours.
* The endpoint is rate-limited by Discord; a transient failure answers `"status": "error"` in a search, and the next search retries.

> [!WARNING]
>
> Bios and connected account names are text written by users. Show them as text, never as HTML, and do not follow their links automatically.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.