modl.gg

Get Linked Accounts

Retrieve alt accounts detected via shared IP addresses.

GET /v1/minecraft/players/{uuid}/linked-accounts

Retrieve accounts that share IP addresses with the specified player. This is used for alt account detection and is limited to a maximum of 20 results.

Authentication

Requires the X-API-Key header with your server's API key.

X-API-Key: your-api-key-here

Request

Headers

HeaderTypeRequiredDescription
X-API-KeystringYesYour server's API key.

Path Parameters

ParameterTypeRequiredDescription
uuidstringYesThe player's Minecraft UUID.

Response

200 OK

{
  "status": 200,
  "linkedAccounts": [
    {
      "_id": "65a1b2c3d4e5f6a7b8c9d0e2",
      "minecraftUuid": "6a1e8400-e29b-41d4-a716-446655440001",
      "usernames": [
        {
          "username": "AltAccount",
          "date": "2024-01-10T08:00:00.000Z"
        }
      ],
      "notes": [],
      "ipList": [
        {
          "ipAddress": "192.168.1.1",
          "country": "US",
          "region": "California",
          "asn": "AS12345",
          "proxy": false,
          "hosting": false,
          "firstLogin": "2024-01-10T08:00:00.000Z",
          "logins": 5
        }
      ],
      "punishments": [],
      "pendingNotifications": []
    }
  ]
}

Response Fields

FieldTypeDescription
linkedAccountsarrayList of player profiles sharing IP addresses with the target player (max 20). Each entry follows the same profile structure as the Get Player by UUID endpoint.

Error Responses

Status CodeDescription
401Missing or invalid API key.
404Player not found for the given UUID.
429Rate limit exceeded.
500Internal server error.

On this page