---
title: "Users"
method: GET
path: "/v1/users"
---

# Users

`GET /v1/users`

List all users in your organization with optional filtering by seat assignment and role status. Supports cursor-based pagination.

## Query parameters

- `seat_filter` 'all' | 'assigned' | 'unassigned'
- `role_filter` 'all' | 'member' | 'admin'
- `limit` integer
- `cursor` string

## Headers

- `x-coderabbitai-api-key` string, required

## Response `200`

List of users with seat and subscription info

- object
  - `seats_purchased` integer, required — Total number of seats purchased in the subscription
  - `seats_assigned` integer, required — Number of seats currently assigned to users
  - `seat_assignment_mode` 'automatic' | 'manual', required — The seat assignment mode for the organization
  - `users` User[], required
    - `user_id` string, required — Unique identifier assigned by the Git provider
    - `seat_assigned` boolean, required — Whether the user has a seat assigned
    - `role` string, required — User role
  - `next_cursor` string, nullable — Cursor for the next page of results, or null if no more results

## Other responses

- `400` — Invalid request
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - Not an admin or missing Enterprise plan
- `410` — Legacy API key - deprecated and no longer supported for user management
- `429` — Rate limit exceeded (10 requests per 60 seconds per organization)
- `500` — Internal server error

---

[API](https://skmtc.net/coderabbit/apis/coderabbit-api-spec.md) · [All operations](https://skmtc.net/coderabbit/apis/coderabbit-api-spec/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coderabbit/coderabbit-api-spec/versions/401789d85d01/schema)