Skip to content
Governance Platform

List memberships for all users in an organization

GET
/api/v1/organizations/{organizationId}/memberships
 
curl --request GET \
  --url https://localhost:8080/api/v1/organizations/example/memberships \
  --header 'Authorization: <Authorization>'

Return every member’s organization role and their project assignments within the organization, ordered by most recent join

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
organizationId
required
string

Organization ID or UUID (bare or urn:uuid)

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Users’ memberships

Media type application/json

Every member of an organization, each with their project assignments

object
organizationId
integer
users
Array<object>

One user’s organization membership together with their project assignments

object
did
string
email
string
invitedAt
string format: date-time
invitedBy
string
joinedAt
string format: date-time
lastLoginAt
string format: date-time
name
string
pictureUrl
string
projects
Array<object>

A user’s assignment to a single project, and the roles it grants

object
assignedAt
string format: date-time
organizationId
integer
projectId
integer
roles
Array<string>
status
string
userId
string
roles
Array<string>
status
string
userId
string
Example generated
{
  "organizationId": 1,
  "users": [
    {
      "did": "example",
      "email": "example",
      "invitedAt": "2026-04-15T12:00:00Z",
      "invitedBy": "example",
      "joinedAt": "2026-04-15T12:00:00Z",
      "lastLoginAt": "2026-04-15T12:00:00Z",
      "name": "example",
      "pictureUrl": "example",
      "projects": [
        {
          "assignedAt": "2026-04-15T12:00:00Z",
          "organizationId": 1,
          "projectId": 1,
          "roles": [
            "example"
          ],
          "status": "example",
          "userId": "example"
        }
      ],
      "roles": [
        "example"
      ],
      "status": "example",
      "userId": "example"
    }
  ]
}

400

Section titled “400 ”

Invalid params

Media type application/json

Error body returned across the auth endpoints; the message is human-readable and not a stable identifier

object
error
string
error_description
string
Example 
{
  "error": "Unauthorized",
  "error_description": "Invalid token"
}

401

Section titled “401 ”

Unauthorized

Media type application/json

Error body returned across the auth endpoints; the message is human-readable and not a stable identifier

object
error
string
error_description
string
Example 
{
  "error": "Unauthorized",
  "error_description": "Invalid token"
}

403

Section titled “403 ”

Forbidden - requires access to this organization

Media type application/json

Error body returned across the auth endpoints; the message is human-readable and not a stable identifier

object
error
string
error_description
string
Example 
{
  "error": "Unauthorized",
  "error_description": "Invalid token"
}

404

Section titled “404 ”

Organization not found

Media type application/json

Error body returned across the auth endpoints; the message is human-readable and not a stable identifier

object
error
string
error_description
string
Example 
{
  "error": "Unauthorized",
  "error_description": "Invalid token"
}

500

Section titled “500 ”

Internal server error

Media type application/json

Error body returned across the auth endpoints; the message is human-readable and not a stable identifier

object
error
string
error_description
string
Example 
{
  "error": "Unauthorized",
  "error_description": "Invalid token"
}