Databases
Retrieve Notion databases and their metadata, including properties, titles, and creation details.
Columns
| Name | Type | ReadOnly | References | Description |
| Id [KEY] | String | True |
Unique database identifier | |
| Object | String | True |
Always 'database' | |
| CreatedTime | Datetime | True |
Database creation timestamp | |
| CreatedByObject | String | True |
Creator object type | |
| CreatedById | String | True |
Users.Id |
Creator user ID |
| LastEditedTime | Datetime | True |
Last modification timestamp | |
| LastEditedByObject | String | True |
Last editor object type | |
| LastEditedById | String | True |
Users.Id |
Last editor user ID |
| Title | String | False |
Database title rich text array | |
| Description | String | False |
Database description rich text array | |
| IconType | String | True |
Icon type The allowed values are external, emoji, file. | |
| Icon | String | False |
Complete icon object with type and data | |
| Cover | String | False |
Cover image object | |
| Properties | String | True |
Database schema properties definition | |
| Parent | String | False |
Parent object specifying the page to create the database under; must include the type discriminator, e.g. { | |
| ParentType | String | True |
Parent container type The allowed values are page_id, workspace, block_id. | |
| ParentWorkspace | Boolean | True |
True if parent is workspace | |
| Url | String | True |
Notion workspace URL | |
| PublicUrl | String | True |
Public web URL if published | |
| Archived | Boolean | True |
Archive status | |
| InTrash | Boolean | False |
Trash status | |
| IsInline | Boolean | False |
Inline display status | |
| RequestId | String | True |
API request identifier |