Member Details

GraphQL Endpoint to fetch member details in your Discord Server

GraphQL Query

query MembersDetails($pageSize: Int, $page: Int, $guildId: String) {
    membersDetails(page: $page, pageSize: $pageSize, guildId: $guildId) {
        totalMembers
        membersList {
            id
            name
            engagementStatus
            numMessages
            channels
            avatarUrl
            dateJoined
            roles {
                id
                name
            }
        }
    }
}

Variables

{
    "pageSize": Int, // Number of members entries in a fetch. Upper limit = 100
    "page": Int, // Page number
    "guildId": String // Guild id of the discord server
}

Response

{
    "totalMembers": Int, // Total Number of Members
    "membersList": Array<{
        "id": Int, // Discord ID of the Member
        "name": String, // Discord Name of the Member (Discord name + '#' + Discriminator)
        "engagementStatus":  "not_engaged" | "highly_engaged" | "engaged", // Engagement level of Member in the Server over past 15 days
        "numMessages" : Int, // Number of messages by the member over past 15 days
        "channels": Array<String>, // Channels the member is part of
        "avatarUrl": String, // Avatar URL of the member
        "dateJoined": String, // Date in ISO Format on which the member last joined
        "roles": Array<{
            "id": Int, // Discord ID of the Role member has
            "name": String, // Name of the Role member has
        }>
    }>
}

Example

POST https://dashboard.withblaze.app/api/graphql-api

Query Parameters

NameTypeDescription

page*

1

Page number should start from 1

pageSize*

10

Max Limit - 100

guildId

GUILD-ID

Optional: Guild ID of the Discord Server

If the guild ID is not specified, the data of the discord server that was integrated first will be retrieved

Headers

NameTypeDescription

x-api-key*

API-KEY

Your Blaze API Key

{
  "data": {
    "membersDetails": {
      "totalMembers": "37",
      "membersList": [
        {
          "id": "155149108183695360",
          "name": "Dyno#3861",
          "engagementStatus": "engaged",
          "numMessages": 0,
          "channels": [],
          "avatarUrl": "https://cdn.discordapp.com/avatars/155149108183695360/19a5ee4114b47195fcecc6646f2380b1.png?size=1024",
          "dateJoined": "2022-09-14 04:50:23.107000",
          "roles": [
            {
              "id": "963108554984788029",
              "name": "@everyone"
            },
            {
              "id": "1019470143488798723",
              "name": "Dyno"
            }
          ]
        },
        {
          "id": "1105177107199434772",
          "name": "Opensea test#7260",
          "engagementStatus": "engaged",
          "numMessages": 0,
          "channels": [
            "general"
          ],
          "avatarUrl": "https://cdn.discordapp.com/embed/avatars/0.png",
          "dateJoined": "2023-05-08 16:59:59.789664",
          "roles": [
            {
              "id": "963108554984788029",
              "name": "@everyone"
            },
            {
              "id": "1105177292239556693",
              "name": "Opensea test"
            }
          ]
        },
        {
          "id": "720351927581278219",
          "name": "Invite Tracker#0478",
          "engagementStatus": "engaged",
          "numMessages": 0,
          "channels": [],
          "avatarUrl": "https://cdn.discordapp.com/avatars/720351927581278219/7ac935300e9bc3edcbc2de1b91c597b1.png?size=1024",
          "dateJoined": "2022-06-08 05:15:04.208000",
          "roles": [
            {
              "id": "963108554984788029",
              "name": "@everyone"
            },
            {
              "id": "983962344872869951",
              "name": "Invite Tracker"
            }
          ]
        },
        {
          "id": "704521096837464076",
          "name": "Collab.Land#6372",
          "engagementStatus": "engaged",
          "numMessages": 0,
          "channels": [],
          "avatarUrl": "https://cdn.discordapp.com/avatars/704521096837464076/a2777a4324203bdc054239f96613fd51.png?size=1024",
          "dateJoined": "2022-09-28 14:52:37.201000",
          "roles": [
            {
              "id": "963108554984788029",
              "name": "@everyone"
            },
            {
              "id": "1024695133305831424",
              "name": "collabland-admin"
            },
            {
              "id": "1024695130898317355",
              "name": "Collab.Land"
            }
          ]
        },
        {
          "id": "1031234267444944976",
          "name": "Bot disco testing#0233",
          "engagementStatus": "engaged",
          "numMessages": 0,
          "channels": [],
          "avatarUrl": "https://cdn.discordapp.com/embed/avatars/3.png",
          "dateJoined": "2022-10-16 16:00:16.779000",
          "roles": [
            {
              "id": "963108554984788029",
              "name": "@everyone"
            },
            {
              "id": "1031235139616907275",
              "name": "Bot disco testing"
            }
          ]
        },
        {
          "id": "609737854578589706",
          "name": "Parth Lawania#1395",
          "engagementStatus": "engaged",
          "numMessages": 0,
          "channels": [],
          "avatarUrl": "https://cdn.discordapp.com/avatars/609737854578589706/c6669ac69dd629da750dfab98a37a486.png?size=1024",
          "dateJoined": "2022-09-28 16:13:24.194000",
          "roles": [
            {
              "id": "963108554984788029",
              "name": "@everyone"
            },
            {
              "id": "1024697108701384704",
              "name": "collab-land-wallet-connected"
            },
            {
              "id": "1022913603461980282",
              "name": "twitter-follows-blaze"
            },
            {
              "id": "1022912780195598416",
              "name": "hold-1-eth"
            },
            {
              "id": "986758116035141662",
              "name": "test"
            },
            {
              "id": "979437611779244072",
              "name": "Admin"
            }
          ]
        },
        {
          "id": "1075894480114307216",
          "name": "custom test bot#3020",
          "engagementStatus": "engaged",
          "numMessages": 0,
          "channels": [],
          "avatarUrl": "https://cdn.discordapp.com/embed/avatars/0.png",
          "dateJoined": "2023-02-16 21:43:36.567436",
          "roles": [
            {
              "id": "963108554984788029",
              "name": "@everyone"
            },
            {
              "id": "1075895248879882334",
              "name": "custom test bot"
            }
          ]
        },
        {
          "id": "913182305097494568",
          "name": "larfy#6011",
          "engagementStatus": "engaged",
          "numMessages": 0,
          "channels": [
            "general",
            "onboarding",
            "collab-land-only"
          ],
          "avatarUrl": "https://cdn.discordapp.com/avatars/913182305097494568/cdb6cdbd1df295ad8b88ff9b57a8ed19.png?size=1024",
          "dateJoined": "2022-10-05 23:42:02.154000",
          "roles": [
            {
              "id": "963108554984788029",
              "name": "@everyone"
            },
            {
              "id": "1059210997610578030",
              "name": "Secret"
            },
            {
              "id": "1024697108701384704",
              "name": "collab-land-wallet-connected"
            },
            {
              "id": "1022913603461980282",
              "name": "twitter-follows-blaze"
            },
            {
              "id": "1022912780195598416",
              "name": "hold-1-eth"
            },
            {
              "id": "979437611779244072",
              "name": "Admin"
            }
          ]
        },
        {
          "id": "1019420294705852496",
          "name": "Blaze Bot Goldfinch#3185",
          "engagementStatus": "engaged",
          "numMessages": 0,
          "channels": [],
          "avatarUrl": "https://cdn.discordapp.com/avatars/1019420294705852496/6e6e2ff4de70dce809f7bf89a27d58d4.png?size=1024",
          "dateJoined": "2022-09-14 01:46:00.466000",
          "roles": [
            {
              "id": "963108554984788029",
              "name": "@everyone"
            },
            {
              "id": "1019423743564578948",
              "name": "Blaze Bot Goldfinch"
            }
          ]
        },
        {
          "id": "935088613564219432",
          "name": "brianz#7695",
          "engagementStatus": "engaged",
          "numMessages": 0,
          "channels": [],
          "avatarUrl": "https://cdn.discordapp.com/embed/avatars/0.png",
          "dateJoined": "2022-10-06 14:51:16.979000",
          "roles": [
            {
              "id": "963108554984788029",
              "name": "@everyone"
            },
            {
              "id": "986758116035141662",
              "name": "test"
            }
          ]
        }
      ]
    }
  }
}

Last updated