Skip to main content
GET
/
v1
/
users
/
{user_id}
TypeScript SDK
import { Client } from "@notionhq/client"

const notion = new Client({ auth: process.env.NOTION_API_KEY })

const response = await notion.users.retrieve({
  user_id: "e79a0b74-3aba-4149-9f74-0bb5791a6ee6"
})
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "object": "<string>",
  "name": "<string>",
  "avatar_url": "<string>",
  "type": "<string>",
  "person": {
    "email": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://developers.notion.com/llms.txt

Use this file to discover all available pages before exploring further.

The requested user must belong to the workspace connected to the integration. This endpoint can return workspace members, guests, and bots in that workspace.

​
Errors

Each Public API endpoint can return several possible error codes. See the Error codes section of the Status codes documentation for more information.
Connection capabilitiesThis endpoint requires a connection to have user information capabilities. Attempting to call this API without user information capabilities will return an HTTP response with a 403 status code. For more information on connection capabilities, see the capabilities guide.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Notion-Version
enum<string>
required

The API version to use for this request. The latest version is 2026-03-11.

Available options:
2026-03-11

Path Parameters

​
user_id
string
required

Response

​
id
string<uuid>
required

The ID of the user.

​
object
string
required

The user object type name.

Allowed value: "user"
​
name
string | null
required

The name of the user.

​
avatar_url
string | null
required

The avatar URL of the user.

​
type
string
required

Indicates this user is a person.

Allowed value: "person"
​
person
object
required

Details about the person, when the type of the user is person.