light-mode-image
Learn
API ReferenceMembers

Retrieve tenant members

Analytics Events

TENANT_MEMBER_RETRIEVE_LIST_STARTTENANT_MEMBER_RETRIEVE_LIST_SUCCESSTENANT_MEMBER_RETRIEVE_LIST_FAIL
GET/v1/tenants/{tenantId}/members

Retrieves a list of all users that have access to the tenant.

Analytic events

  • TENANT_MEMBER_RETRIEVE_LIST_START
  • TENANT_MEMBER_RETRIEVE_LIST_SUCCESS
  • TENANT_MEMBER_RETRIEVE_LIST_FAIL

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

tenantId*string

Identifier of the tenant to retrieve.

Formatuuid

Query Parameters

limit?number

Range size of returned list.

Default100
Range1 <= value <= 1000
cursor?string

Starting point for the list of entries.

Response Body

application/json

application/json

text/plain

curl -X GET "https://manage.mattr.global/v1/tenants/543e0579-87b9-4705-be78-8f7f54709838/members"
{
  "data": [
    {
      "id": "8f6d40a9-d913-45e8-aa3e-8c99d62cd8fb",
      "email": "john-doe@example.com",
      "name": "John Doe",
      "status": "Active",
      "roles": [
        "dts-provider",
        "issuer"
      ],
      "permissions": [
        "dids:read",
        "dids:create"
      ],
      "inviteExpiresAt": "2025-08-22T12:00:00.000Z"
    }
  ],
  "nextCursor": "Y3JlYXRlZEF0PTIwMjAtMDgtMjVUMDY6NDY6MDkuNTEwWiZpZD1hNjZmZmVhNS04NDhlLTQzOWQtODBhNC1kZGE1NWY1M2UzNmM"
}
{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}
"Unauthorized"
Empty
Empty

How would you rate this page?

Invite a tenant member POST

Invites a user to join the tenant and assigns roles to them within the tenant's context. If the user has not registered to the Self Service Portal yet, then they will receive an email with a link to accept the invite. If the user has already registered, then they will be added as a member to the tenant immediately. ### **Analytic events** * TENANT_MEMBER_INVITATION_CREATE_START * TENANT_MEMBER_INVITATION_CREATE_SUCCESS * TENANT_MEMBER_INVITATION_CREATE_FAIL

Retrieve a tenant member GET

Retrieves an existing user that has access to the tenant. ### **Analytic events** * TENANT_MEMBER_RETRIEVE_START * TENANT_MEMBER_RETRIEVE_SUCCESS * TENANT_MEMBER_RETRIEVE_FAIL