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.
/ accounts. v1. Accounts/ GetUsersRequest 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?stringURL of the user's avatar image, taken from their linked Discord account. Empty when there is none.
createdAt?stringWhen the account was created.
Format"date-time"
email?stringThe user's email address, stored lowercase and unique across users.
id?stringOpaque 16-byte identifier of the user, assigned when the account is created. Base64-encoded in JSON.
Format"byte" base64
isAdministrator?booleanTrue when the user is a platform administrator with access across every workspace.
name?stringThe user's display name, 1 to 256 characters.
status?stringThe account's status. A suspended user can no longer sign in.
Value in"USER_"USER_
updatedAt?stringWhen the account was last changed.
Format"date-time"
application/json
The request was malformed, such as a missing required field or an unparseable cursor.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request lacks a valid API key in the Authorization header.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The API key is not allowed to perform this action on this workspace.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request was rate limited. Slow down and retry later.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
An internal server error occurred.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
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=="
]
}'const res = await fetch("https://api.goldmine.to/accounts.v1.Accounts/GetUsers", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"userIds": [
"EjRWeBI0VniQEjRWeBI0Vg==",
"q83vq83vEjRWeBI0VniQqg=="
]
}),
});
const data = await res.json();body := strings.NewReader(`{
"userIds": [
"EjRWeBI0VniQEjRWeBI0Vg==",
"q83vq83vEjRWeBI0VniQqg=="
]
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/accounts.v1.Accounts/GetUsers", body)
if err != nil {
return err
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("CSTRADER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)import os, requests
res = requests.post(
"https://api.goldmine.to/accounts.v1.Accounts/GetUsers",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"userIds": [
"EjRWeBI0VniQEjRWeBI0Vg==",
"q83vq83vEjRWeBI0VniQqg=="
]
},
)
data = res.json(){
"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=="
]
}{
"code": "invalid_argument",
"message": "The request was malformed, such as a missing required field or an unparseable cursor."
}{
"code": "unauthenticated",
"message": "The request lacks a valid API key in the Authorization header."
}{
"code": "permission_denied",
"message": "The API key is not allowed to perform this action on this workspace."
}{
"code": "resource_exhausted",
"message": "The request was rate limited. Slow down and retry later."
}{
"code": "internal",
"message": "An internal server error occurred."
}