Zernio
APIFor you
Zernio
APIFor you
API Reference

Discord

Settings

Get Discord account settingsGETUpdate Discord settingsPATCHList Discord guild channelsGET

Messaging

Send a Discord Direct MessagePOSTList pinned messagesGETPin a Discord messagePUTUnpin a Discord messageDELETECreate a Discord public threadPOSTCrosspost Discord messagePOSTDelete a Discord channel messageDELETE

Roles & Members

List Discord guild rolesGETCreate a Discord guild rolePOSTEdit a Discord guild rolePATCHDelete a Discord guild roleDELETEList Discord guild membersGETSearch Discord guild membersGETGet a Discord guild memberGETAssign a role to a guild memberPUTRemove a role from a guild memberDELETE

Scheduled Events

List Discord scheduled eventsGETCreate a Discord scheduled eventPOSTGet a Discord scheduled eventGETUpdate a Discord scheduled eventPATCHDelete a Discord scheduled eventDELETE
Dashboard
OverviewPlatformsAPI ReferenceResources
Discord

Search Discord guild members

Search guild members whose username or nickname starts with the query (Discord matches prefixes only, not substrings).

Cheaper than paginating the full member listing when you already know who you are looking for.

GET
/v1/discord/guilds/{guildId}/members/search

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Path Parameters

guildId*string

Query Parameters

accountId*string
query*string

Username or nickname prefix to match.

Length1 <= length <= 100
limit?integer
Range1 <= value <= 1000
Default25

Response Body

application/json

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.discord.searchDiscordGuildMembers({  path: {    guildId: 'guild_abc123',  },  query: {    accountId: 'account_abc123',    query: 'string',  },});console.log(data);
{  "data": [    {      "user": {        "id": "string",        "username": "string",        "discriminator": "string",        "avatar": "string",        "global_name": "string"      },      "nick": "string",      "roles": [        "string"      ],      "joined_at": "2019-08-24T14:15:22Z",      "premium_since": "2019-08-24T14:15:22Z"    }  ]}
Was this page helpful?

List Discord guild members

Cursor-paginated list of guild members. Returns Discord's raw member objects so callers can build community-ops automation (e.g. "add role to all members joined in the last 7 days") on the actual platform shape. Pagination: pass `after` = the last `user.id` from the previous page. Omit on the first call. Response includes a `nextCursor` and `hasMore` flag so callers don't need to know Discord's pagination shape.

Get a Discord guild member

Fetch a single guild member by Discord user id. Cheaper than paginating the full member listing when you already know who you are looking for.