---
title: "List current account members and pending invites"
method: GET
path: "/v1/accounts/me/members"
tags: ["Accounts"]
---

# List current account members and pending invites

`GET /v1/accounts/me/members`

## Request

- Base URL: `https://api.checklyhq.com`
- URL: `https://api.checklyhq.com/v1/accounts/me/members`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/checklyhq/apis/checkly-public-api/docs/v1/accounts/me/members/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `search` string: Case-insensitive partial match against member name, member email, and invite email. Empty searches are ignored.
- `type` 'member' | 'invite': Filter by account member list item type.
- `role` 'OWNER' | 'ADMIN' | 'READ_WRITE' | 'READ_RUN' | 'READ_ONLY': Filter by account role. Valid filters may produce no results for invites.
- `status` 'ACTIVE' | 'PENDING' | 'EXPIRED': Filter by member or invite status. Valid filters may produce no results for some item types.
- `limit` integer: Page length. Omitted returns all matching members and invites.
- `nextId` string: Opaque cursor returned from a previous limited request. Only accepted with limit and the same query params.

## Headers

- `x-checkly-account` string, uuid: Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

## Response `200`

Successful

- AccountMembersList
  - `members` AccountMembersListItems[], required
    - union
      - AccountMember
        - `type` 'member', required
        - `accountId` string, uuid, required
        - `userId` string, uuid, required
        - `name` string, nullable, required
        - `email` string, email, required
        - `role` 'OWNER' | 'ADMIN' | 'READ_WRITE' | 'READ_RUN' | 'READ_ONLY' | 'CUSTOM', required
        - `customRole` object, nullable, required: The custom role held when role is CUSTOM; null otherwise.
          - `id` string, uuid, required
          - `name` string, required
        - `status` 'ACTIVE', required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
        - `isSupportMembership` boolean, required
        - `ssoEnabled` boolean, required
        - `mfaEnabled` boolean, required
      - AccountInvite
        - `type` 'invite', required
        - `id` string, uuid: The invite id. Present only when the caller may send this invite. Sending it takes members:create and every permission of the invite's role.
        - `accountId` string, uuid, required
        - `email` string, email, required
        - `role` 'ADMIN' | 'READ_WRITE' | 'READ_RUN' | 'READ_ONLY' | 'CUSTOM', required
        - `customRole` object, nullable, required: The custom role held when role is CUSTOM; null otherwise.
          - `id` string, uuid, required
          - `name` string, required
        - `status` 'PENDING' | 'EXPIRED', required
        - `inviterEmail` string, email, required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
        - `expiresAt` string, date-time, required
  - `length` integer, required: Number of items returned in this page. This is not the total matching count.
  - `nextId` string, nullable, required: Opaque cursor for the next page. Null means there are no more results.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests

## Changes

- **2026-10-31** `bc90d1bfa738`: 1 breaking, 2 warning, 5 info
  - the response property `members/items/oneOf[#/components/schemas/AccountInvite]/id` became optional for the status `200`
  - added the new `CUSTOM` enum value to the `members/items/oneOf[#/components/schemas/AccountInvite]/role` response property for the response status `200`
  - added the new `CUSTOM` enum value to the `members/items/oneOf[#/components/schemas/AccountMember]/role` response property for the response status `200`
  - added the optional property `errorCode` to the response with the `401` status
  - …4 more

[Operation history](https://skmtc.dev/checklyhq/apis/checkly-public-api/changes/v1/accounts/me/members/get.md)

---

[API](https://skmtc.dev/checklyhq/apis/checkly-public-api.md) - [All operations](https://skmtc.dev/checklyhq/apis/checkly-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/checklyhq/apis/checkly-public-api/revisions/bc90d1bfa738?raw)