---
title: "List all users"
method: GET
path: "/v1/users"
tags: ["Users"]
---

# List all users

`GET /v1/users`

## Query parameters

- `start_cursor` string
- `page_size` number

## Headers

- `Notion-Version` '2026-03-11', required

## Response `200`

- object
  - `type` 'user', required
  - `user` EmptyObject, required
  - `object` 'list', required
  - `next_cursor` string, nullable, required
  - `has_more` boolean, required
  - `results` UserObjectResponse[], required
    - union
      - object
        - `id` string, uuid, required
        - `object` 'user', required — The user object type name.
        - `name` string, nullable, required — The name of the user.
        - `avatar_url` string, nullable, required — The avatar URL of the user.
        - `type` 'person', required — Indicates this user is a person.
        - `person` object, required — Details about the person, when the `type` of the user is `person`.
          - `email` string — The email of the person.
          - `email_verified` boolean — Whether the person's email is verified.
      - object
        - `id` string, uuid, required
        - `object` 'user', required — The user object type name.
        - `name` string, nullable, required — The name of the user.
        - `avatar_url` string, nullable, required — The avatar URL of the user.
        - `type` 'bot', required — Indicates this user is a bot.
        - `bot` union, required — Details about the bot, when the `type` of the user is `bot`.
          - EmptyObject
          - BotInfoResponse
            - `owner` union, required — Details about the owner of the bot.
              - …
            - `workspace_id` string, required — The ID of the bot's workspace.
            - `workspace_limits` object, required — Limits and restrictions that apply to the bot's workspace
              - …
            - `workspace_name` string, nullable, required — The name of the bot's workspace.

## Other responses

- `400`
- `401`
- `403`
- `404`
- `406`
- `409`
- `429`
- `500`
- `503`
- `504`
- `529`

---

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