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
}