Skip to main content
GET
/
api
/
v1
/
public
/
roblox-to-discord
Map Roblox ID to Discord IDs
curl --request GET \
  --url https://api.docksys.xyz/api/v1/public/roblox-to-discord \
  --header 'Authorization: Bearer <token>'
{
  "status": 200,
  "data": {
    "robloxId": "12345",
    "discordIds": [
      "67890",
      "54321"
    ]
  },
  "timestamp": "2025-09-27T20:12:56Z",
  "version": "1.0.0",
  "requestsRemaining": 499,
  "ipRequestsRemaining": 98
}
Lookup Endpoint Standard Premium Expanded
Use this endpoint to resolve a Roblox user ID into one or more linked Discord user IDs. Standard responses return the core mapping, while Premium responses also include expanded Discord identity and guild-member details.

​
What this endpoint returns

Standard response

Returns the core mapping between robloxId and linked discordIds, plus response metadata like version and remaining quota.

Premium response

Includes the standard mapping and an additional resolved.discord object with expanded Discord user and guild-member details.
Standard access returns the linked Discord IDs for the provided Roblox ID, along with envelope metadata such as timestamp and requestsRemaining.
Premium access includes everything in the standard response plus a detailed resolved.discord object keyed by Discord user ID.

​
Response examples

Standard Response
{
  "status": 200,
  "data": {
    "robloxId": "1234567890",
    "discordIds": ["135791357913579135"]
  },
  "timestamp": "2025-11-15T20:12:56Z",
  "version": "1.1.0",
  "requestsRemaining": 499
}
Standard responses return the linked Discord IDs without the expanded resolved object.

​
Response highlights

​
status
number
required
HTTP status code returned by the API.
​
data.robloxId
string
required
Roblox user ID used for the lookup.
​
data.discordIds
string[]
required
Array of Discord user IDs currently linked to the provided Roblox account.
​
resolved
object
Premium-only expanded Discord payload.
​
resolved.discord
object
Premium object keyed by Discord user ID. Each key contains enriched Discord user and guild-member data for that linked account.
​
resolved.discord.{discordId}.displayName
string
Discord global display name for the linked user.
​
resolved.discord.{discordId}.username
string
Discord username for the linked user.
​
resolved.discord.{discordId}.id
string
Discord user ID for the enriched record.
​
resolved.discord.{discordId}.avatar
string | null
Avatar URL for the linked Discord account.
​
resolved.discord.{discordId}.banner
string | null
Banner URL for the linked Discord account when available.
​
resolved.discord.{discordId}.nickname
string | null
Guild nickname for the linked member when available.
​
resolved.discord.{discordId}.joinedAt
string | null
Timestamp showing when the linked member joined the guild.
​
resolved.discord.{discordId}.createdAt
string
Timestamp showing when the Discord account was created.
​
resolved.discord.{discordId}.roles
object[]
Array of guild roles for the linked member, including role ID and role name.
​
timestamp
string
required
ISO 8601 timestamp for when the response was generated.
​
version
string
required
Dock API version that handled the request.
​
requestsRemaining
number
Remaining requests in the authenticated quota bucket.

​
Premium enrichment includes

Discord identity

Username, display name, user ID, avatar, banner, and account creation date.

Guild member details

Nickname, join date, and full guild role list for each linked Discord user.
Standard is enough when you only need the raw mapping. Premium is better for dashboards, moderation tooling, account review flows, and richer user displays.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
robloxId
string
required

The Roblox user ID.

​
guildId
string
required

The Discord guild ID.

Response

Successful response with linked Discord IDs.

​
status
enum<integer>

The HTTP status code of the response.

Available options:
200
​
data
object
​
timestamp
string<date-time>

The timestamp of the response in ISO 8601 format.

​
version
string

The API version.

Example:

"1.0.0"

​
requestsRemaining
integer | null

Number of requests remaining in the daily quota.

​
ipRequestsRemaining
integer | null

Remaining IP-linked quota shared across API keys detected on the same IP.