Discord profile

The profile module on its own: everything public about a Discord account, from its ID. Answering 200 or 404 takes 1 search from your quota; 400, 451 and 429 take none.

GET /v1/profile/{id}

Profile

cURL

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

200

{
  "id": "<string>",
  "username": "nelly",
  "displayName": "Nelly",
  "discriminator": "<string>",
  "bot": true,
  "system": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "accountAgeDays": 4100,
  "avatar": {
    "url": "<string>",
    "animated": true,
    "default": true
  },
  "banner": {
    "url": "<string>",
    "animated": true
  },
  "accentColor": "#5865f2",
  "bannerColor": "<string>",
  "serverTag": {
    "tag": "DOG",
    "guildId": "<string>",
    "badgeUrl": "<string>"
  },
  "badges": [
    {
      "id": "<string>",
      "name": "<string>",
      "iconUrl": "<string>"
    }
  ],
  "history": {
    "usernames": [
      {
        "value": "<string>",
        "firstSeen": "2023-11-07T05:31:56Z",
        "lastSeen": "2023-11-07T05:31:56Z"
      }
    ],
    "displayNames": [
      {
        "value": "<string>",
        "firstSeen": "2023-11-07T05:31:56Z",
        "lastSeen": "2023-11-07T05:31:56Z"
      }
    ],
    "previousNames": [
      {
        "name": "<string>",
        "seenAt": "<string>"
      }
    ]
  },
  "fetchedAt": "2023-11-07T05:31:56Z"
}

Everything public about a Discord account, from its ID: usernames, display name and its Nitro style, avatar, banner, avatar decoration, nameplate, server tag, badges, Nitro signals and creation date, plus every username and display name DisDog has seen for it before. 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 profile module. About the module →

Profiles are re-read from Discord at most every 15 minutes (fetchedAt). history holds what DisDog itself has observed, so it grows with every lookup.

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

Profile

Trimmed; the live response carries more nested fields (decoration, nameplate, name style).

id · string

username · string

Example:

"nelly"

displayName · string | null

Example:

"Nelly"

discriminator · string | null

Only on legacy name#1234 accounts.

bot · boolean

system · boolean

createdAt · string<date-time>

accountAgeDays · integer

Example:

4100

avatar · object

Show child attributes

banner · object | null

Show child attributes

accentColor · string | null

Example:

"#5865f2"

bannerColor · string | null

serverTag · object | null

Show child attributes

badges · object[]

Show child attributes

history · object

Show child attributes

fetchedAt · string<date-time>