SimpleLinks Docs

Lookup Actions

Read-only endpoints for resolving Steam IDs, Discord IDs, names, and verification status. None of these mutate state.

GETfindBySteamguildlookup

Return the Discord ID linked to a Steam ID, or 404 if not linked.

Parameters

action* (query)
string
Must be findBySteam.
id* (query)
string
Steam 64 ID.

Response

"349279096745754624"

Example

curl "https://simplelinks.cc/api?action=findBySteam&id=76561198000000000" \
  -H "X-API-Key: sl_live_…"
GETfindByDiscordguildlookup

Return the Steam ID linked to a Discord ID. discordCheck is an alias for backwards compatibility.

Parameters

id* (query)
string
Discord user ID (snowflake).

Response

"76561198000000000"
GETisLinkedSteamBulkguildlookup

Bulk check whether each Steam ID is linked in this guild. steamChecks is an alias.

Parameters

id* (query)
string
Comma-separated Steam IDs (e.g. 76561...,76561...).

Response

{
  "76561198000000001": true,
  "76561198000000002": false
}
GETnitroChecksguildlookup

Bulk check Nitro status for each Steam ID.

Parameters

id* (query)
string
Comma-separated Steam IDs.

Response

{
  "76561198000000001": true,
  "76561198000000002": false
}
GETgroupChecksguildlookup

For each Steam ID, check membership in a Steam Group. Falls back to the guild's default group if group omitted.

Parameters

id* (query)
string
Comma-separated Steam IDs.
group (query)
string
Steam Group ID. Defaults to guild.steam_group_id.

Response

{
  "76561198000000001": true,
  "76561198000000002": false
}
GETgetSteamguildlookup

Return the Steam display name linked to a Discord ID. Returns false if not linked.

Parameters

id* (query)
string
Discord user ID.

Response

"PlayerName"
POSTgetSteamBulkguildlookup

Bulk fetch Steam names for many Discord IDs in one call.

Request Body

{
  "discord_ids": ["349279…", "123456…"]
}

Response

{
  "349279…": "PlayerOne",
  "123456…": "PlayerTwo"
}
GETgetDiscordguildlookup

Return the Discord username linked to a Discord ID, or false.

Parameters

id* (query)
string
Discord user ID.

Response

"joker"
GETcountguildlookup

Total number of linked users in this guild.

Response

{ "Total": 1842 }
GETlistAllLinkedguildlookup

Return every (discord_id, steam_id) pair in this guild. Use sparingly; this is a full scan.

Response

[
  { "discord_id": "349…", "steam_id": "7656…" },
  …
]
GETlistNitroguildlookup

List Discord IDs flagged as Nitro in this guild. Returns { Result: 0 } with status 404 if none.

Response

{
  "Result": [
    { "discord_id": "349…" }
  ]
}