---
title: "List users"
method: GET
path: "/user/list"
tags: ["User"]
---

# List users

`GET /user/list`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/user/list`
- Auth: HTTP bearer

## Query parameters

- `cursor` string: The cursor to use for pagination
- `order` 'asc' | 'desc': The order of the paginated items
- `take` integer: The number of items to retrieve
- `meta` object: Key-value pairs to filter the users by metadata

## Response `200`

The list of users was retrieved successfully

- object
  - `items` object[], required
    - `name` string: The associated name
    - `description` string: The associated description
    - `meta` Meta: Meta data information
    - `id` string, required: The instance ID
    - `createdAt` number, required: The timestamp (ms) when the instance was created
    - `updatedAt` number, required: The timestamp (ms) when the instance was updated
    - `image` string: The image of the user
    - `email` string: The email of the user
    - `limits` Limits: Limits information
      - `tokens` number: The tokens limit
      - `conversations` number: The conversations limit
      - `messages` number: The messages limit
      - `database` object: The database limits
        - `datasets` number: The datasets limit
        - `records` number: The records limit
        - `skillsets` number: The skillsets limit
        - `abilities` number: The abilities limit
        - `files` number: The files limit
  - `cursor` string, required: Cursor for fetching the next page

## Other responses

- `default`: An error response

---

[API](https://skmtc.dev/chatbotkit/apis/cbk-api.md) · [All operations](https://skmtc.dev/chatbotkit/apis/cbk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatbotkit/apis/cbk-api/revisions/13d250576136?raw)