# List members

> Get the professionals on your Quenza team through the API, with their role and status, including pending and suspended members.

Source: https://quenza.com/help/api/members/list-members/

Returns everyone on the team: active members, members who have not accepted their invitation yet (`pending`) and suspended members. The list is sorted by last name, then first name.

`role` is `owner`, `manager`, `billing_manager` or `member`. [Roles and permissions](https://quenza.com/help/team/roles-and-permissions/) explains what each role can do.

## Request

`GET https://developers.quenza.com/v1/members`

### Query parameters

- `offset` (integer): How many records to skip. Defaults to `0`.
- `limit` (integer): How many records to return, from 1 to 100. Defaults to `20`.

### Example

```bash
curl https://developers.quenza.com/v1/members \
  -H "Authorization: Bearer $QUENZA_API_TOKEN" \
  -H "Accept: application/json"
```

## Response

200 OK.

### Fields of each record in data

- `id` (string): The member’s ID. Use it to update the member or to find their tasks.
- `email` (string): Email address.
- `first_name` (string): First name.
- `last_name` (string): Last name.
- `status` (string): `pending` until the member accepts the invitation, then `active`. `suspended` while the member is suspended. One of `active`, `pending`, `suspended`
- `role` (string): Role in the workspace. One of `owner`, `manager`, `billing_manager`, `member`
- `timezone` (string): Time zone as an IANA name, such as `Europe/Amsterdam`.
- `phone` (string, or null): Phone number as free text, such as `+31 6 1234 5678`, or `null`.
- `company` (string, or null): Company or practice name, or `null`.
- `website` (string, or null): Website address, such as `https://example.com`, or `null`.
- `address` (string, or null): Street and house number, or `null`.
- `city` (string, or null): City, or `null`.
- `state` (string, or null): State or region, or `null`.
- `country_code` (string, or null): Two-letter country code in lower case, such as `nl`, or `null`.
- `invited_at` (string, or null): When the invitation email was sent. ISO 8601 date and time in UTC
- `invitation_accepted_at` (string, or null): When the invitation was accepted, or `null` while it is pending. ISO 8601 date and time in UTC
- `created_at` (string): When it was created. ISO 8601 date and time in UTC
- `updated_at` (string): When it was last changed. ISO 8601 date and time in UTC

```json
{
  "data": [
    {
      "id": "H2V7N4QX",
      "email": "sarah.bennett@example.com",
      "first_name": "Sarah",
      "last_name": "Bennett",
      "status": "active",
      "role": "owner",
      "timezone": "Europe/Amsterdam",
      "phone": "+31 20 555 0142",
      "company": "Bright Path Coaching",
      "website": "https://example.com",
      "address": "Keizersgracht 100",
      "city": "Amsterdam",
      "state": null,
      "country_code": "nl",
      "invited_at": null,
      "invitation_accepted_at": null,
      "created_at": "2025-03-10T14:20:00.000000Z",
      "updated_at": "2026-10-01T08:00:00.000000Z"
    },
    {
      "id": "K9T3W6PB",
      "email": "daniel.weber@example.com",
      "first_name": "Daniel",
      "last_name": "Weber",
      "status": "active",
      "role": "member",
      "timezone": "Europe/Amsterdam",
      "phone": null,
      "company": "Bright Path Coaching",
      "website": "https://example.com",
      "address": null,
      "city": "Amsterdam",
      "state": null,
      "country_code": "nl",
      "invited_at": "2026-11-15T10:10:00.000000Z",
      "invitation_accepted_at": "2026-11-15T12:00:00.000000Z",
      "created_at": "2026-11-15T10:10:00.000000Z",
      "updated_at": "2026-11-15T10:10:00.000000Z"
    }
  ],
  "meta": {
    "limit": 20,
    "offset": 0,
    "total": 2
  },
  "links": {
    "next": null,
    "prev": null
  }
}
```

Status codes: 200 OK, 401 Unauthenticated, 402 Workspace not active, 403 Not on your plan, 406 Not acceptable. See /help/api/errors/.
