Notion/getUsers

Online calls unavailable · details below

NotionNotion collaborative workspace API

GET/v1/users

List all users

Paginates over the users a connection can see in the workspace.

Manage pages, blocks, data sources/databases, comments, file uploads, views, users, and search through the official versioned Notion API, with OAuth and async tasks. The complete boundary is the 49 endpoints in the official OpenAPI snapshot; workspace data is private user content, so Pontx does not proxy, cache, or aggregate it and callers use the local SDK/CLI directly.

Request

operationId: getUsers
Server: https://api.notion.com
Authentication: bearerAuth, basicAuth

Request parameters

`start_cursor`

querystring

Pagination start cursor (opaque).

example content

`page_size`

querynumber

Number of results per page.

`Notion-Version`

headerstringrequired

API version date for the request; the current latest version is 2026-03-11.

2026-03-11

Responses

`200`

objectapplication/json

Request succeeded.

Properties: has_morenext_cursorobjectresultstypeuser

`400`

error_api_400application/json

Request parameters are invalid.

`401`

error_api_401application/json

Unauthenticated or the token is invalid.

`403`

error_api_403application/json

Access to the resource is forbidden.

`404`

error_api_404application/json

The requested resource was not found.

`406`

error_api_406application/json

The request cannot be represented as requested.

`409`

error_api_409application/json

The request conflicts with the current state of the resource.

`429`

error_api_429application/json

Rate limited; retry after Retry-After.

`500`

error_api_500application/json

Upstream internal error.

`503`

error_api_503application/json

Upstream service temporarily unavailable.

`504`

error_api_504application/json

Upstream gateway timeout.

`529`

error_api_529application/json

Upstream overloaded; retry like a 429.

{
  "has_more": true,
  "next_cursor": "example content",
  "object": "list",
  "type": "user",
  "user": {}
}