Skip to main content

Get Guild Member

Retrieve details of a specific member in a guild. Requires the guilds.reviewer permission.

Endpoint​

GET /api/v2/guilds/:guildId/members/:userId

Authentication​

This endpoint requires:

  1. JWT Token: User authentication
  2. Permission: guilds.reviewer role
Authorization: Bearer user-jwt-token-here

Description​

Returns the member details for a specific user within a guild. Use this to check membership status and role.

Path Parameters​

ParameterTypeRequiredDescription
guildIdstringYesUnique identifier for the guild
userIdstringYesUnique identifier for the user

Request Example​

GET /api/v2/guilds/guild-123/members/user-456

Response​

Success Response (200)​

{
  "userId": "user-456",
  "username": "player2",
  "role": "member",
  "joinedAt": 1672617600000
}

Error Response (401)​

{
  "message": "Unauthorized",
  "status": 401
}

Error Response (403)​

{
  "message": "Forbidden",
  "status": 403
}

Error Response (404)​

{
  "message": "Member user-456 not found in guild guild-123",
  "status": 404
}

Response Fields​

FieldTypeDescription
userIdstringUser ID of the member
usernamestringDisplay name of the member
rolestringMember role: admin or member
joinedAtnumberWhen the member joined (Unix ms)

Usage Example​

const response = await fetch("https://api.intraverse.io/api/v2/guilds/guild-123/members/user-456", {
  headers: {
    Authorization: `Bearer ${jwtToken}`,
  },
});

if (response.ok) {
  const member = await response.json();
  console.log(`${member.username} is a ${member.role}`);
  console.log(`Joined: ${new Date(member.joinedAt).toLocaleDateString()}`);
} else {
  console.log("Member not found");
}

Next Steps​