NotionNotion collaborative workspace API
GET/v1/databases/{database_id}
Retrieve a database
Returns a database object and its property schema by ID (legacy database resource).
Manage pages, blocks, data sources/databases, comments, file uploads, views, users, and search through the official versioned Notion API, with OAuth and async tasks. The complete boundary is the 49 endpoints in the official OpenAPI snapshot; workspace data is private user content, so Pontx does not proxy, cache, or aggregate it and callers use the local SDK/CLI directly.
Request
- operationId
retrieveDatabase- Server
https://api.notion.com- Authentication
- bearerAuth, basicAuth
Request parameters
database_id
pathidRequestrequired
Notion-Version
headerstringrequired
API version date for the request; the current latest version is 2026-03-11.
2026-03-11
Responses
200
stringapplication/json
Request succeeded.
400
error_api_400application/json
Request parameters are invalid.
401
error_api_401application/json
Unauthenticated or the token is invalid.
403
error_api_403application/json
Access to the resource is forbidden.
404
error_api_404application/json
The requested resource was not found.
406
error_api_406application/json
The request cannot be represented as requested.
409
error_api_409application/json
The request conflicts with the current state of the resource.
429
error_api_429application/json
Rate limited; retry after Retry-After.
500
error_api_500application/json
Upstream internal error.
503
error_api_503application/json
Upstream service temporarily unavailable.
504
error_api_504application/json
Upstream gateway timeout.
529
error_api_529application/json
Upstream overloaded; retry like a 429.