Get User
This route does not require a valid Authorization header, however it is preferred to provide it.
GET/users/<identifier>
Get a user using a User Identifier.
This does not require authorization when not using @me, but authorized users will get a separate rate limit which is usually (hopefully) higher than the guest rate limit.
Path Params
| Name | Type |
|---|---|
| identifier | UserIdentifier |
Response
200User
| Field | Type | Description |
|---|---|---|
| id | Number | The user’s ID. |
| username | String | The user’s username. This field has to be between 2 and 32 characters long. |
| display_name? | String | The user’s display name. This field has to be between 2 and 32 characters long. |
| social_credit | Number | The user’s social credit score. |
| status | Status | The user’s status. |
| bio? | String | The user’s bio. The upper limit is the instance’s Instance Info bio_limit. |
| avatar? | Number | The user’s avatar. This field has to be a valid file ID in the “avatar” bucket. |
| banner? | Number | The user’s banner. This field has to be a valid file ID in the “banner” bucket. |
| badges | Number | The user’s badges as a bitfield. |
| permissions | Number | The user’s instance-wide permissions as a bitfield. |
| email? | String | The user’s email. This is only shown when the user queries their own data. |
| verified? | Boolean | The user’s verification status. This is only shown when the user queries their own data. |
Example
curl \
-H "Authorization: <token>" \
https://api.eludris.gay/users/@me
{
"id": 48615849987333,
"username": "yendri",
"social_credit": 0,
"badges": 0,
"permissions": 0
}