Notion API - Public Beta (English)
  1. Database
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
      • Retrieve your token's bot user
      • Retrieve a user
    • 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. Database

Database

Database objects describe the property schema of a database in Notion. Pages are the items (or children) in a database. Page property values must conform to the property objects laid out in the parent database object.

All databases#

📘#

Properties marked with an * are available to integrations with any capabilities. Other properties require read content capabilities in order to be returned from the Notion API. For more information on integration capabilities, see the capabilities guide.
FieldTypeDescriptionExample value
object*stringAlways "database"."database"
id*string (UUID)Unique identifier for the database."2f26ee68-df30-4251-aad4-8ddc420cba3d"
created_timestring (ISO 8601 date and time)Date and time when this database was created. Formatted as an ISO 8601 date time string."2020-03-17T19:10:04.968Z"
created_byPartial UserUser who created the database.{"object": "user","id": "45ee8d13-687b-47ce-a5ca-6e2e45548c4b"}
last_edited_timestring (ISO 8601 date and time)Date and time when this database was updated. Formatted as an ISO 8601 date time string."2020-03-17T21:49:37.913Z"
last_edited_byPartial UserUser who last edited the database.{"object": "user","id": "45ee8d13-687b-47ce-a5ca-6e2e45548c4b"}
titlearray of rich text objectsName of the database as it appears in Notion. See rich text object) for a breakdown of the properties."title": [ { "type": "text", "text": { "content": "Can I create a URL property", "link": null }, "annotations": { "bold": false, "italic": false, "strikethrough": false, "underline": false, "code": false, "color": "default" }, "plain_text": "Can I create a URL property", "href": null } ]
descriptionarray of rich text objectsDescription of the database as it appears in Notion. See rich text object) for a breakdown of the properties.
iconFile Object or Emoji objectPage icon.
coverFile object (only type of "external" is supported currently)Page cover image.
properties*objectSchema of properties for the database as they appear in Notion. key string The name of the property as it appears in Notion. value object A Property object.
parentobjectInformation about the database's parent. See Parent object.{ "type": "page_id", "page_id": "af5f89b5-a8ff-4c56-a5e8-69797d11b9f8" }
urlstringThe URL of the Notion database."https://www.notion.so/668d797c76fa49349b05ad288df2d136"
archivedbooleanThe archived status of the database.false
is_inlinebooleanHas the value true if the database appears in the page as an inline block. Otherwise has the value false if the database appears as a child page.false
Modified at 2023-04-28 06:46:24
Previous
Page properties
Next
Database properties
Built with