Skip to content

API Reference / Users

Fetch multiple users by ID

Returns the user accounts for a list of IDs in a single call. IDs that do not match a user are reported separately so the caller can tell which were missing.

POST/accounts.v1.Accounts/GetUsers

Request body

application/jsonRequired

Request for several users by identifier in one call, limited to members of the caller's workspace.

userIds?array<string>

Opaque 16-byte identifiers of the users to fetch, each base64-encoded in JSON.

Response body

application/json

Success

notFoundIds?array<string>

Requested identifiers with no user visible to the caller.

users?array<User>

The users that exist and are visible to the caller.

Show attributes
avatarUrl?string

URL of the user's avatar image, taken from their linked Discord account. Empty when there is none.

createdAt?string

When the account was created.

Format"date-time"

email?string

The user's email address, stored lowercase and unique across users.

id?string

Opaque 16-byte identifier of the user, assigned when the account is created. Base64-encoded in JSON.

Format"byte" base64

isAdministrator?boolean

True when the user is a platform administrator with access across every workspace.

name?string

The user's display name, 1 to 256 characters.

status?string

The account's status. A suspended user can no longer sign in.

Value in"USER_STATUS_ACTIVE""USER_STATUS_SUSPENDED"

updatedAt?string

When the account was last changed.

Format"date-time"

curl -X POST "https://api.goldmine.to/accounts.v1.Accounts/GetUsers" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userIds": [
      "EjRWeBI0VniQEjRWeBI0Vg==",
      "q83vq83vEjRWeBI0VniQqg=="
    ]
  }'
{
  "users": [
    {
      "id": "EjRWeBI0VniQEjRWeBI0Vg==",
      "name": "Jordan Hale",
      "email": "jordan@acme.example",
      "status": "active",
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-03-02T14:22:30Z"
    }
  ],
  "notFoundIds": [
    "q83vq83vEjRWeBI0VniQqg=="
  ]
}