Retrieves a database object, information that describes the structure and columns of a database, for a provided database ID. The response adheres to any limits to an integration’s capabilities.

To fetch database rows rather than columns, use the Query a database endpoint.


How to find a database ID

You need the ID of a target Notion database to query this endpoint. To find a database ID, copy the database URL. The ID is the string of characters in the URL that is between the slash following the workspace name (if applicable) and the question mark. The ID is a 32 characters alphanumeric string. Refer to the Create an integration guide for more details.


Additional resources


The Notion API does not support retrieving linked databases.

To fetch the information in a linked database, share the original source database with your Notion integration.