Skip to content

API Reference / Memberships

Fetch multiple memberships by ID

Returns the memberships for a list of IDs in a single call. IDs that do not match a membership are reported separately.

POST/accounts.v1.Accounts/GetMemberships

Request body

application/jsonRequired

Request for several memberships by identifier in one call, limited to the caller's workspace and the caller's own invitations.

membershipIds?array<string>

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

Response body

application/json

Success

memberships?array<Membership>

The memberships that exist and are visible to the caller.

Show attributes
createdAt?string

When the membership was created, which for a member is when they were invited.

Format"date-time"

expiresAt?string

When a pending invitation stops being acceptable. Unset once accepted and for an owner.

Format"date-time"

id?string

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

Format"byte" base64

invitedBy?string

Opaque 16-byte identifier of the user who sent the invitation. Unset for the workspace owner and for invitations sent before the inviter was recorded.

Format"byte" base64

lastActiveAt?string

When the member last used the workspace while signed in, to the minute. Unset for a member who has not used it since activity was recorded.

Format"date-time"

policies?array<string>

Names of the policies a member holds: any of "trading", "steam", "proxies", "analytics" and "csfloat". Empty means a read-only member. Not used for an owner or an administrator, who hold every operational permission by role.

role?string

Owner for the one person who holds the workspace (its creator until ownership is transferred), administrator for someone who runs it with the owner but cannot delete it, hand it over or change roles, or member for everyone else.

Value in"MEMBERSHIP_ROLE_OWNER""MEMBERSHIP_ROLE_MEMBER""MEMBERSHIP_ROLE_ADMINISTRATOR"

status?string

Invited until the invited user accepts, then accepted.

Value in"MEMBERSHIP_STATUS_INVITED""MEMBERSHIP_STATUS_ACCEPTED"

updatedAt?string

When the membership was last changed, such as accepted or given new policies.

Format"date-time"

userId?string

Opaque 16-byte identifier of the member user, base64-encoded in JSON.

Format"byte" base64

workspaceId?string

Opaque 16-byte identifier of the workspace, base64-encoded in JSON.

Format"byte" base64

notFoundIds?array<string>

Requested identifiers with no membership visible to the caller, including memberships in other workspaces.

curl -X POST "https://api.goldmine.to/accounts.v1.Accounts/GetMemberships" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "membershipIds": [
      "VniQq83vEjRWeBI0VniQqw==",
      "ICEiIyQlJicoKSorLC0uLw=="
    ]
  }'
{
  "memberships": [
    {
      "id": "VniQq83vEjRWeBI0VniQqw==",
      "userId": "EjRWeBI0VniQEjRWeBI0Vg==",
      "workspaceId": "AAECAwQFBgcICQoLDA0ODw==",
      "role": "MEMBERSHIP_ROLE_OWNER",
      "status": "MEMBERSHIP_STATUS_ACCEPTED",
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-01-15T10:00:00Z"
    }
  ],
  "notFoundIds": [
    "ICEiIyQlJicoKSorLC0uLw=="
  ]
}