# Members & invites: List members of a tenant (https://docs.envocal.ai/api-reference/members-and-invites/list-members-of-a-tenant/)

> Direct members only, sorted by email. Members of parent tenants also have access but are listed at their own tenant.

## GET `/v1/tenants/{tenantId}/members`

Direct members only, sorted by email. Members of parent tenants also have access but are listed at their own tenant.

**Required permission:** `members:read`

### Parameters

| Name | In | | Type | Description |
| --- | --- | --- | --- | --- |
| `tenantId` | path | required | string | Tenant id, or `current` for the key's own tenant. Must be the key's tenant or one of its sub-tenants. |

### Responses

**200** — TenantMemberDto[]: The members.

| Field | Type | | Description |
| --- | --- | --- | --- |
| `tenantId` | string | required | Tenant id. |
| `userId` | string | required | User id; use it to change the role or remove the member. |
| `email` | string | required | The user's email address. |
| `firstName` | string | required | First name. |
| `lastName` | string | required | Last name. |
| `role` | TenantRole |  | Role in this tenant. Members of a parent tenant act as admins here. |

**401**: Missing, invalid, revoked or expired API key.

**403**: The key lacks the required permission, or the tenant/resource is outside its reach.

**429**: Rate limit exceeded. Retry after the number of seconds in the Retry-After header.

### Example

```bash
curl -X GET "https://api.envocal.ai/v1/tenants/current/members" \
  -H "Authorization: Bearer evk_eu_..."
```