List all users

GET

https://api.notion.com/v1/users

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.notion.com/v1/users?start_cursor=' \
--header 'Notion-Version;'

Response Example

200 - Success-List all users

{
  "results": [
    {
      "object": "user",
      "id": "d40e767c-d7af-4b18-a86d-55c61f1e39a4",
      "type": "person",
      "person": {
        "email": "avo@example.org",
      },
      "name": "Avocado Lovelace",
      "avatar_url": "https://secure.notion-static.com/e6a352a8-8381-44d0-a1dc-9ed80e62b53d.jpg",
    },
    {
      "object": "user",
      "id": "9a3b5ae0-c6e6-482d-b0e1-ed315ee6dc57",
      "type": "bot",
      "bot": {},
      "name": "Doug Engelbot",
      "avatar_url": "https://secure.notion-static.com/6720d746-3402-4171-8ebb-28d15144923c.jpg",
    }
  ],
  "next_cursor": "fe2cc560-036c-44cd-90e8-294d5a74cebc",
  "has_more": true
}

Request

Query Params

start_cursor

string

optional

Header Params

Notion-Version

string

required

Responses

🟢200OK-List all users

application/json

Body

object {0}

🟠400Bad Request-List all users

Modified at 2023-04-28 08:49:29

Retrieve a user

Retrieve your token's bot user