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

# Get user permissions

`POST` `/get-user-permissions`

Get every permission a user has.

## Headers

| Name   | Value                |
| ------ | -------------------- |
| apikey | 28-Character API Key |

## Body

| Name            | Type     | Description                                                                 |
| --------------- | -------- | --------------------------------------------------------------------------- |
| userId          | string\* | ID of the user to get permissions for                                       |
| discordBotToken | string\* | Your Discord bot token                                                      |
| channelId       | string\* | Channel to check permissions for (optional; defaults to global permissions) |
| guildId         | string\* | Server ID                                                                   |

## Response

<Tabs>
  <Tab title="200: OK">
    ```json theme={null}
    {
      "success": true,
      "permissions": ["VIEW_CHANNEL", "SEND_MESSAGES", "MANAGE_MESSAGES"]
    }
    ```
  </Tab>

  <Tab title="400: Bad Request">
    **Error**\
    You didn't provide a valid:

    * userId
    * discordBotToken
    * guildId
    * channelId (the given channelId didn't exist)

    Check `response.error`
  </Tab>

  <Tab title="401: Unauthorized">
    **Error**\
    Missing or invalid apikey.
  </Tab>

  <Tab title="429: Too Many Requests">
    You sent too many requests too quickly. Try again later.
  </Tab>
</Tabs>