---
title: "List users"
method: GET
path: "/accounts/{account_id}/users"
tags: ["Users"]
---

# List users

`GET /accounts/{account_id}/users`

List all users for an account with cursor-based pagination.

## Path parameters

- `account_id` string, required — The account ID to list users for.

## Query parameters

- `after` string — Cursor for forward pagination. Use the next_cursor from a previous response.
- `before` string — Cursor for backward pagination. Use the previous_cursor from a previous response.

## Response `200`

List of users

- UserList — A paginated list of users
  - `data` User[], required — The list of users
    - `first_name` string, required — The user's first name.
    - `id` string — Unique identifier for the object.
    - `last_name` string — The user's last name.
    - `metadata` Metadata — Set of key-value pairs that will be stored with the object.
    - `photo_url` string, uri — URL of a photo to be used as the user's avatar.
  - `pagination` Pagination, required — Cursor-based pagination information
    - `next_cursor` string, nullable — Cursor for the next page of results. Null if there is no next page.
    - `previous_cursor` string, nullable — Cursor for the previous page of results. Null if there is no previous page.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/surgeapi/apis/surge.md) · [All operations](https://skmtc.net/surgeapi/apis/surge/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/surgeapi/surge/revisions/33842756c9f9/schema)