> For the complete documentation index, see [llms.txt](https://api.stormsystems.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api.stormsystems.org/query-user.md).

# Query User

<mark style="color:green;">`GET`</mark> `/users`

### Parameters

| Key       | Value                                                                                                   |
| --------- | ------------------------------------------------------------------------------------------------------- |
| discordId | [User Discord ID](https://support.discord.com/hc/en-us/articles/206346498#h_01HRSTXPS5H5D7JBY2QKKPVKNA) |

### **Response**

{% tabs %}
{% tab title="200" %}
{% code fullWidth="false" %}

```json
{
    "code": 200,
    "username": "Display Name (username)", # Discord display and username returned.
    "reputation": 0, # Reputation (out of 100).
    "reputationImage": "https://stormsystems.org/assets/images/reputation/0.png",
    "accolades": [], # Accolades include STORM Partner, Staff etc.
    "deductions": 4, # The number of deductions someone has.
    "profile": false # Will only show as a URL if they have a public profile.
}
```

{% endcode %}

This is a correct (OK) response which returns all the available data back.

<mark style="color:green;">`Example URL`</mark>`/users?discordId=1234568910`
{% endtab %}

{% tab title="400" %}

```json
{
  "code": 400,
  "message": "Bad request. Required argument 'discordId' is missing."
}
```

Missing the discordId header to specify which user to query.
{% endtab %}

{% tab title="401" %}

```json
{
  "code": 401,
  "message": "Unauthorized. Invalid or msising API key."
}
```

Missing API Access. See ['API Access'](/introduction.md#api-access) on Introduction.
{% endtab %}

{% tab title="405" %}

```json
{
  "code": 405,
  "message": "Method Not Allowed. Only GET requests are supported."
}
```

Invalid request type. Must be GET.
{% endtab %}

{% tab title="429" %}

```json
{
  "code": 429,
  "message": "Too Many Requests. Rate limit exceeded. Please try again later."
}
```

Rate limit exceeded. See [Rate Limiting](/introduction.md#rate-limiting) or contact STORM Team.
{% endtab %}
{% endtabs %}