v19

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-037759134.1 KB

users

Get multiple users

get/users

Response

Expected response to a valid request

usernamestring required

The user's username

namestring nullable

The user's display name

emailstring email nullable

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

biostring

A description of the user

idstring required

The user's ID

avatar_urlstring required

The user's avatar url

createdstring ISO-8601 required

The time at which the user was created

role'admin' | 'moderator' | 'developer' required

The user's role

badgesinteger

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

auth_providersstring[] nullable

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

email_verifiedboolean nullable

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

has_passwordboolean nullable

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

has_totpboolean nullable

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

github_idinteger nullable

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

Example response

[
  {
    "username": "my_user",
    "name": "My User",
    "bio": "My short biography",
    "payout_data": {
      "payout_wallet": "paypal",
      "payout_wallet_type": "email",
      "payout_address": "support@modrinth.com"
    },
    "id": "EEFFGGHH",
    "avatar_url": "https://avatars.githubusercontent.com/u/11223344?v=1",
    "role": "developer",
    "badges": 63,
    "auth_providers": [
      "github",
      "gitlab",
      "steam",
      "microsoft",
      "google",
      "discord"
    ]
  }
]