---
title: "List company members."
method: GET
path: "/users"
tags: ["Identity"]
---

# List company members.

`GET /users`

## Query parameters

- `limit` string — Page size, 1–100 (default 25).
- `cursor` string — Opaque cursor from a prior response nextCursor.
- `role` 'admin' | 'member' | 'manager' | 'bookkeeper' | 'card_only' | 'lender' — Filter by member role.
- `status` 'active' | 'pending' — active members or pending invitations.
- `email` string — Case-insensitive exact match on the member email.
- `name` string — Case-insensitive substring match on the member name.

## Response `200`

A page of members.

- object
  - `data` User[], required
    - `id` string, required
    - `name` string, required
    - `email` string, required
    - `role` 'admin' | 'member' | 'manager' | 'bookkeeper' | 'card_only' | 'lender' | 'null', nullable, required
    - `status` 'active' | 'pending', required
    - `createdAt` string, required — ISO 8601 timestamp.
  - `nextCursor` string, nullable, required — Pass back as ?cursor for the next page; null on the last page.

---

[API](https://skmtc.dev/joinarc/apis/arc-api.md) · [All operations](https://skmtc.dev/joinarc/apis/arc-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/joinarc/arc-api/revisions/f0dc4aa0fe84/schema)