Skip to main content
GET
/
api
/
v1
/
public
/
discord-to-roblox
Map Discord ID to Roblox ID
curl --request GET \
  --url https://api.docksys.xyz/api/v1/public/discord-to-roblox \
  --header 'Authorization: Bearer <token>'
{
  "status": 200,
  "data": {
    "discordId": "67890",
    "robloxId": "12345"
  },
  "timestamp": "2025-09-27T20:12:56Z",
  "version": "1.0.0",
  "requestsRemaining": 499,
  "ipRequestsRemaining": 499
}
Lookup Endpoint Standard Premium Expanded
Use this endpoint to resolve a linked Discord user ID into its connected Roblox account. Standard responses return the core mapping, while Premium responses also include an expanded Roblox profile payload.

What this endpoint returns

Standard response

Returns the core mapping between discordId and robloxId, plus request metadata like version and remaining quota.

Premium response

Includes the standard mapping and an additional resolved object with Roblox profile details such as display name, description, avatars, badges, and groups.
Standard access returns the linked Roblox ID for the provided Discord ID, along with envelope metadata such as timestamp, requestsRemaining, and ipRequestsRemaining.
Premium access includes everything in the standard response plus a full resolved object containing enriched Roblox profile data.

Response examples

Standard Response
{
  "status": 200,
  "data": {
    "discordId": "67890",
    "robloxId": "156319135"
  },
  "timestamp": "2025-11-15T20:44:57.768Z",
  "version": "1.1.0",
  "requestsRemaining": 499,
  "ipRequestsRemaining": 499
}
Standard responses return the linked Roblox account without the expanded resolved profile object.

Response highlights

status
number
required
HTTP status code returned by the API.
data.discordId
string
required
Discord user ID used for the lookup.
data.robloxId
string
required
Roblox user ID currently linked to the provided Discord account.
resolved
object
Premium-only expanded Roblox profile payload. Includes identity, avatar, moderation, badge, and group metadata.
resolved.username
string
Roblox username for the linked account.
resolved.displayName
string
Current Roblox display name.
resolved.description
string | null
Roblox profile bio or description.
resolved.created
string
Roblox account creation timestamp.
resolved.isBanned
boolean
Whether the linked Roblox account is banned.
resolved.hasVerifiedBadge
boolean
Whether the Roblox account has a verified badge.
resolved.avatar
object
Premium avatar asset URLs, including headshot and fullBody.
resolved.badges
object[]
Premium array of Roblox badges associated with the user.
resolved.groups
object[]
Premium array of Roblox group memberships, including role and rank metadata.
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.
ipRequestsRemaining
number
Remaining shared-IP quota when shared-IP enforcement is active.

Premium enrichment includes

Profile identity

Username, display name, account ID, description, creation date, ban state, and verified badge status.

Expanded assets

Headshot and full-body avatar URLs, Roblox badges, and group membership details with role metadata.
If you only need the raw account mapping, the standard response is enough. If you need richer profile data for dashboards, moderation, or user displays, use Premium.

Authorizations

Authorization
string
header
required

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

Query Parameters

discordId
string
required

The Discord user ID.

guildId
string
required

The Discord guild ID.

Response

Successful response with linked Roblox ID.

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.