MinecraftAuth.me

API documentation

Contents: Look up linked accounts

Look up linked accounts

Request#

GET /api/v2/lookup/{platform}/{identifier}[?include=platform,...]

Finds the player who linked {identifier} on {platform} and returns their linked accounts, each as far as privacy allows.

Auth optional; application credentials add what players granted the application
include comma-separated platform ids to return (default: all)

Examples#

Anonymous:

curl -A "MyPlugin/1.0" https://minecraftauth.me/api/v2/lookup/minecraft/069a79f4-44e9-4726-a5be-fca90e38aaf5
{
  "accounts": {
    "minecraft": { "identifier": "069a79f4-44e9-4726-a5be-fca90e38aaf5" },
    "twitch": { "hint": true }
  }
}

Here the player set Twitch to Hint and Discord to Hidden, so Discord isn't listed. The same request made by an application the player approved for Discord:

curl -A "MyApp/1.0" -u "AppAppAppAppApp1:<secret>" \
  https://minecraftauth.me/api/v2/lookup/minecraft/069a79f4-44e9-4726-a5be-fca90e38aaf5
{
  "accounts": {
    "minecraft": { "identifier": "069a79f4-44e9-4726-a5be-fca90e38aaf5" },
    "discord": { "identifier": "111111111111111111" },
    "twitch": { "hint": true }
  }
}

Filtering with include#

With include, only the requested platforms are returned. If none of them are visible, accounts is empty ({"accounts": {}}), which isn't an error.

Status codes#

Status When
200 found
400 unknown platform (in the path or include), or a malformed identifier
401/403 credentials were sent but are wrong (see Errors)
404 nobody linked that account, or it isn't visible to you, so it can't be looked up by