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-fca90e38aaf5val request = HttpRequest.newBuilder(
URI("https://minecraftauth.me/api/v2/lookup/minecraft/069a79f4-44e9-4726-a5be-fca90e38aaf5"))
.header("User-Agent", "MyPlugin/1.0")
.build()
val response = client.send(request, HttpResponse.BodyHandlers.ofString())const response = await fetch(
"https://minecraftauth.me/api/v2/lookup/minecraft/069a79f4-44e9-4726-a5be-fca90e38aaf5",
{ headers: { "User-Agent": "MyPlugin/1.0" } },
);req, _ := http.NewRequest("GET",
"https://minecraftauth.me/api/v2/lookup/minecraft/069a79f4-44e9-4726-a5be-fca90e38aaf5", nil)
req.Header.Set("User-Agent", "MyPlugin/1.0")
resp, err := http.DefaultClient.Do(req){
"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-fca90e38aaf5val credentials = Base64.getEncoder().encodeToString("AppAppAppAppApp1:$secret".toByteArray())
val request = HttpRequest.newBuilder(
URI("https://minecraftauth.me/api/v2/lookup/minecraft/069a79f4-44e9-4726-a5be-fca90e38aaf5"))
.header("User-Agent", "MyApp/1.0")
.header("Authorization", "Basic $credentials")
.build()
val response = client.send(request, HttpResponse.BodyHandlers.ofString())const response = await fetch(
"https://minecraftauth.me/api/v2/lookup/minecraft/069a79f4-44e9-4726-a5be-fca90e38aaf5",
{
headers: {
"User-Agent": "MyApp/1.0",
Authorization: `Basic ${btoa(`AppAppAppAppApp1:${secret}`)}`,
},
},
);req, _ := http.NewRequest("GET",
"https://minecraftauth.me/api/v2/lookup/minecraft/069a79f4-44e9-4726-a5be-fca90e38aaf5", nil)
req.Header.Set("User-Agent", "MyApp/1.0")
req.SetBasicAuth("AppAppAppAppApp1", secret)
resp, err := http.DefaultClient.Do(req){
"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 |