Skip to main content
Lookup endpoints tell you which Roblox account a Discord user is linked to in your guild, and the reverse. Results are scoped to your guild: a user must be verified in your guild to appear. All lookup endpoints read the guild from the X-Guild-ID header.
Every endpoint on this page requires the lookup:read scope. See Scopes.

Look up by Discord ID

string
required
The Discord user ID to resolve.
string
required
The guild to look in. Must match your API key’s guild.
object
API key responses are limited to these four fields. Extra fields such as verified_at and last_sync are only returned to dashboard sessions, not to API keys.

Look up by Roblox ID

The reverse direction.
number
required
The Roblox user ID to resolve.
string
required
The guild to look in.
The response shape matches Look up by Discord ID.

Batch lookup

Resolve up to 25 IDs in one call. Pass either discord_ids or roblox_ids.
string
required
The guild to look in.
string[]
Up to 25 Discord IDs.
number[]
Up to 25 Roblox IDs.
object
A map keyed by the ID you passed. Each value is the link object, or null if that user is not verified in the guild.
Batches are capped at 25 IDs per request to prevent enumeration. A larger list returns 400.

Reverse lookup

Given one ID, return the full link record. This is the single-record version of batch lookup.
string
required
string
Provide this or roblox_id.
number
Provide this or discord_id.