Goldmine
Memberships

Fetch multiple memberships by ID

POST
/accounts.v1.Accounts/GetMemberships

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/accounts.v1.Accounts/GetMemberships" \  -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=="
  ]
}
{
  "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."
}

GetMembership

Returns the membership identified by the given ID, including the member's role, invitation status, and granted operational policies.

ListMemberships

Lists memberships, optionally filtered to a single workspace or user. Results are paginated; pass the returned cursor to fetch the next page.