List and search site members

Returns a paginated list of members for the site. Use query parameters to filter by email, status (active/blocked), verified, or paid flags. Supports full-text search on email and display name via the q parameter.

Use this when you need to find members by criteria or browse all members. If you already have a specific member's ID and need their access group memberships, use getMember instead — listMembers does not include group assignments in the response.

Each member in the response includes: id (UUID), email, displayName, status (active or blocked), verified flag, paid flag, and timestamps (registeredAt, lastLoginAt, createdAt, updatedAt).

Results use cursor-based pagination. Pass the nextCursor value from the response as the after query parameter to fetch the next page. Default page size is 50, maximum is 100.

GET /api/v1/members
Bearer token

Query parameters

· 9
limit integer · min: 1· max: 100· default: 50

Number of items to return per page (1-100). Default: 50.

after string · uuid

Cursor for pagination. Pass the nextCursor value from a previous response to get the next page of results.

email string · email

Filter by exact email address. Use this to look up a specific member when you know their email but not their UUID.

status string · enum

Filter by member status. 'active' = can access the site, 'blocked' = denied access.

values

  • active
  • blocked
verified string · enum

Filter by email verification status. 'true' = verified, 'false' = not verified.

values

  • true
  • false
paid string · enum

Filter by paid status. 'true' = paying customer, 'false' = free.

values

  • true
  • false
q string · max length: 200

Full-text search across email and display name. Case-insensitive substring match. Use this to find members when you only have a partial name or email.

sort string · default: createdAt· enum

Field to sort results by. Default: 'createdAt'.

values

  • createdAt
  • email
  • lastLoginAt
order string · default: desc· enum

Sort direction. Default: 'desc' (newest first).

values

  • asc
  • desc

Responses