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.

Property

Type

Description

Example value

object*

string

Always "database".

"database"

id*

string (UUID)

Unique identifier for the database.

"2f26ee68-df30-4251-aad4-8ddc420cba3d"

created_time

string (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_by

Partial User

User who created the database.

{"object": "user","id": "45ee8d13-687b-47ce-a5ca-6e2e45548c4b"}

last_edited_time

string (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_by

Partial User

User who last edited the database.

{"object": "user","id": "45ee8d13-687b-47ce-a5ca-6e2e45548c4b"}

title

array of rich text objects

Name of the database as it appears in Notion.
See rich text object) for a breakdown of the properties.

description

array of rich text objects

Description of the database as it appears in Notion.
See rich text object) for a breakdown of the properties.

icon

File Object or Emoji object

Page icon.

cover

File object (only type of "external" is supported currently)

Page cover image.

properties*

object

Schema 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.

parent

object

Information about the database's parent. See Parent object.

{ "type": "page_id", "page_id": "af5f89b5-a8ff-4c56-a5e8-69797d11b9f8" }

url

string

The URL of the Notion database.

"https://www.notion.so/668d797c76fa49349b05ad288df2d136"

archived

boolean

The archived status of the database.

false

is_inline

boolean

Has 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