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>"
  }
}

​
Errors

Each Public API endpoint can return several possible error codes. See the Error codes section of the Status codes documentation for more information.
Integration capabilitiesThis endpoint requires an integration 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 integration 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 2025-09-03.

Available options:
2025-09-03

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.