> ## Documentation Index
> Fetch the complete documentation index at: https://technified.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Lookup

> Resolve verification links between Discord and Roblox accounts.

Lookup endpoints tell you which Roblox account a Discord user is linked to in your guild, and the reverse. Results are scoped to your guild: a user must be verified in your guild to appear.

All lookup endpoints read the guild from the `X-Guild-ID` header.

> [!NOTE]
>
> Every endpoint on this page requires the `lookup:read` scope. See [Scopes](https://technified.mintlify.site/developer-api/introduction.md#scopes).

## Look up by Discord ID

```http theme={null}
GET /lookup/discord/:discordId
```

**discordId** `string` *required*

The Discord user ID to resolve.

**X-Guild-ID** `string` *required*

The guild to look in. Must match your API key's guild.

**data** `object`

**properties**

**discord\_id** `string`

**roblox\_id** `number`

**roblox\_username** `string`

**verified** `boolean`

> [!NOTE]
>
> API key responses are limited to these four fields. Extra fields such as `verified_at` and `last_sync` are only returned to dashboard sessions, not to API keys.

```bash cURL theme={null}
curl "https://api.technified.xyz/api/v1/lookup/discord/123456789012345678" \
  -H "X-API-Key: $TECHNIFIED_API_KEY" \
  -H "X-Guild-ID: $GUILD_ID"
```

```json 200 theme={null}
{
  "status": "success",
  "code": 200,
  "message": "User found",
  "data": {
    "discord_id": "123456789012345678",
    "roblox_id": 261,
    "roblox_username": "Shedletsky",
    "verified": true
  }
}
```

```json 404 theme={null}
{
  "status": "error",
  "code": 404,
  "message": "User not found or not verified in this guild",
  "details": { "code": "NOT_FOUND" }
}
```

## Look up by Roblox ID

The reverse direction.

```http theme={null}
GET /lookup/roblox/:robloxId
```

**robloxId** `number` *required*

The Roblox user ID to resolve.

**X-Guild-ID** `string` *required*

The guild to look in.

The response shape matches [Look up by Discord ID](#look-up-by-discord-id).

```bash cURL theme={null}
curl "https://api.technified.xyz/api/v1/lookup/roblox/261" \
  -H "X-API-Key: $TECHNIFIED_API_KEY" \
  -H "X-Guild-ID: $GUILD_ID"
```

## Batch lookup

Resolve up to 25 IDs in one call. Pass either `discord_ids` or `roblox_ids`.

```http theme={null}
POST /lookup/status
```

**guild\_id** `string` *required*

The guild to look in.

**discord\_ids** `string[]`

Up to 25 Discord IDs.

**roblox\_ids** `number[]`

Up to 25 Roblox IDs.

**data.results** `object`

A map keyed by the ID you passed. Each value is the link object, or `null` if that user is not verified in the guild.

```bash cURL theme={null}
curl "https://api.technified.xyz/api/v1/lookup/status" \
  -H "X-API-Key: $TECHNIFIED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "guild_id": "'$GUILD_ID'",
    "discord_ids": ["123456789012345678", "234567890123456789"]
  }'
```

```json 200 theme={null}
{
  "status": "success",
  "code": 200,
  "message": "Batch lookup complete",
  "data": {
    "results": {
      "123456789012345678": {
        "discord_id": "123456789012345678",
        "roblox_id": 261,
        "roblox_username": "Shedletsky",
        "verified": true
      },
      "234567890123456789": null
    }
  }
}
```

> [!WARNING]
>
> Batches are capped at 25 IDs per request to prevent enumeration. A larger list returns `400`.

## Reverse lookup

Given one ID, return the full link record. This is the single-record version of batch lookup.

```http theme={null}
POST /reverse
```

**guild\_id** `string` *required*

**discord\_id** `string`

Provide this or `roblox_id`.

**roblox\_id** `number`

Provide this or `discord_id`.

```bash cURL theme={null}
curl "https://api.technified.xyz/api/v1/reverse" \
  -H "X-API-Key: $TECHNIFIED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "guild_id": "'$GUILD_ID'", "roblox_id": 261 }'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.