Skip to content
Modrinth Documentation

Get multiple users

GET
/users

Parameters

Query Parameters

ids
required
string
["AABBCCDD", "EEFFGGHH"]

The IDs of the users

Responses

200

Expected response to a valid request

Array
object
username
required

The user’s username

string
my_user
name

The user’s display name

string
nullable 
My User
email

The user’s email (only displayed if requesting your own account). Requires USER_READ_EMAIL PAT scope.

string format: email
nullable
bio

A description of the user

string
My short biography
payout_data

Various data relating to the user’s payouts status (you can only see your own)

object
balance

The payout balance available for the user to withdraw (note, you cannot modify this in a PATCH request)

integer
10.11223344556678
payout_wallet

The wallet that the user has selected

string
Allowed values: paypal venmo 
paypal
payout_wallet_type

The type of the user’s wallet

string
Allowed values: email phone user_handle 
email
payout_address

The user’s payout address

string
support@modrinth.com
id
required

The user’s ID

string
EEFFGGHH
avatar_url
required

The user’s avatar url

string
https://avatars.githubusercontent.com/u/11223344?v=1
created
required

The time at which the user was created

string format: ISO-8601
role
required

The user’s role

string
Allowed values: admin moderator developer 
developer
badges

Any badges applicable to this user. These are currently unused and undisplayed, and as such are subject to change

In order from first to seventh bit, the current bits are:

  • (unused)
  • EARLY_MODPACK_ADOPTER
  • EARLY_RESPACK_ADOPTER
  • EARLY_PLUGIN_ADOPTER
  • ALPHA_TESTER
  • CONTRIBUTOR
  • TRANSLATOR
integer format: bitfield 
63
auth_providers

A list of authentication providers you have signed up for (only displayed if requesting your own account)

Array<string>
nullable 
[
  "github",
  "gitlab",
  "steam",
  "microsoft",
  "google",
  "discord"
]
email_verified

Whether your email is verified (only displayed if requesting your own account)

boolean
nullable
has_password

Whether you have a password associated with your account (only displayed if requesting your own account)

boolean
nullable
has_totp

Whether you have TOTP two-factor authentication connected to your account (only displayed if requesting your own account)

boolean
nullable
github_id

Deprecated - this is no longer public for security reasons and is always null

integer
nullable