> ## 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.

# Shield

> Check Roblox users against the global Shield flagged list.

> [!WARNING]
>
> **Shield is currently suspended.** Protection and lookups are offline following Roblox's Third-Party App Policy clarification on June 2, 2026. Remove `SYNC_SHIELD = true` from your integration config until further notice.

These endpoints let you check whether a Roblox user is on the [Technified Shield](https://technified.mintlify.site/shield/overview.md) flagged list. The list itself is maintained centrally by Technified administrators, so a guild API key can only read it. Adding and removing flags is not available through the guild API.

> [!NOTE]
>
> If you run the Roblox integration, enable `SYNC_SHIELD` instead of calling these endpoints yourself. See [How Shield works](https://technified.mintlify.site/shield/how-it-works.md).

## Check one user

```http theme={null}
GET /shield/check/:robloxId
```

**robloxId** `number` *required*

The Roblox user ID to check.

**data.flagged** `boolean`

**data.flag** `object`

Present only when `flagged` is `true`.

**properties**

**roblox\_id** `string`

**roblox\_username** `string`

**reason** `string`

**flagged\_by** `string`

**source** `string`

**category** `string`

**flagged\_at** `number`

```bash cURL theme={null}
curl "https://api.technified.xyz/api/v1/shield/check/261" \
  -H "X-API-Key: $TECHNIFIED_API_KEY"
```

```json Flagged theme={null}
{
  "status": "success",
  "code": 200,
  "data": {
    "flagged": true,
    "flag": {
      "roblox_id": "261",
      "roblox_username": "Shedletsky",
      "reason": "Condo participation",
      "category": "condo",
      "source": "technified",
      "flagged_at": 1746712921
    }
  }
}
```

```json Not flagged theme={null}
{
  "status": "success",
  "code": 200,
  "data": { "flagged": false }
}
```

> [!TIP]
>
> When you call this with a guild key and the user is flagged, Technified also posts a Shield flag kick entry to your Discord log channel if **Shield Flag Kick** logging is enabled. See [How Shield works](https://technified.mintlify.site/shield/how-it-works.md#log-shield-kicks).

## Check many users

Check up to 200 Roblox IDs in one call.

```http theme={null}
POST /shield/batch
```

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

Up to 200 Roblox user IDs.

**data.flagged** `array`

Only the flagged users from your list are returned, each with `roblox_id`, `roblox_username`, `reason`, `source`, and `category`. IDs that are not flagged are simply absent.

```bash cURL theme={null}
curl "https://api.technified.xyz/api/v1/shield/batch" \
  -H "X-API-Key: $TECHNIFIED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "roblox_ids": [261, 156, 1] }'
```

```json 200 theme={null}
{
  "status": "success",
  "code": 200,
  "data": {
    "flagged": [
      {
        "roblox_id": "261",
        "roblox_username": "Shedletsky",
        "reason": "Condo participation",
        "source": "technified",
        "category": "condo"
      }
    ]
  }
}
```


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