Notion API - Public Beta (English)
  1. Users
Notion API - Public Beta (English)
  • Introduction
  • Integration capabilities
  • Request limits
  • Status codes
  • ENDPOINTS
    • Authentication
      • Authentication
      • Token
    • Blocks
      • Delete a block
      • Append block children
      • Retrieve a block
      • Update a block
      • Retrieve block children
    • Databases
      • Filter database entries
      • Sort database entries
      • Update database properties
      • Retrieve a database
      • Update a database
      • Query a database
    • Pages
      • Archive a page
      • Retrieve a page property item
      • Create a page
      • Retrieve a Page
      • Update Page properties
    • Users
      • List all users
        GET
      • Retrieve your token's bot user
        GET
      • Retrieve a user
        GET
    • Comments
      • Create comment
      • Retrieve comments
    • Search
      • Search optimizations and limitations
      • Search by title
  • OBJECTS
    • Block
    • Comment
    • Unfurl attribute object for Link Previews
    • Page
      • Page
      • Page properties
    • Database
      • Database
      • Database properties
    • User
      • User
      • Comment
    • Other
      • Emoji object
      • File object
      • Parent object
      • Rich text object
  • Versioning
    • Versioning
    • Changes by version
  • ENDPOINTS Copy
    • Authentication
      • Authentication
      • Token
    • Blocks
      • Retrieve a block
      • Update a block
      • Retrieve block children
      • Delete a block
      • Append block children
    • Databases
      • Filter database entries
      • Sort database entries
      • Update database properties
      • Retrieve a database
      • Update a database
      • Query a database
      • Create a database
    • Pages
      • Archive a page
      • Retrieve a Page
      • Update Page properties
      • Retrieve a page property item
      • Create a page
    • Users
      • Retrieve a user
      • List all users
      • Retrieve your token's bot user
    • Comments
      • Create comment
      • Retrieve comments
  1. Users

Retrieve a user

GET
/v1/users/{id}
Users
Retrieve a user object using the ID specified in the request path.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/v1/users/'
Response Response Example
{
  "avatar_url": null,
  "id": "6794760a-1f15-45cd-9c65-0dfe42f5135a",
  "name": "Aman Gupta",
  "object": "user",
  "person": {
    "email": "XXXXXXX@makenotion.com"
  },
  "type": "person"
}

Request

Path Params
id
string 
required

Responses

🟢200200 Success - Retrieve a user
application/json
Body
avatar_url
null 
optional
Example:
null
id
string 
optional
Example:
6794760a-1f15-45cd-9c65-0dfe42f5135a
name
string 
optional
Example:
Aman Gupta
object
string 
optional
Example:
user
person
object 
optional
email
string 
optional
Example:
XXXXXXX@makenotion.com
type
string 
optional
Example:
person
Modified at 2023-04-27 10:02:23
Previous
Retrieve your token's bot user
Next
Create comment
Built with