--- title: "Get views for database" method: GET path: "/databases/{id}/views" tags: ["Database"] --- # Get views for database `GET /databases/{id}/views` ## Request - Base URL: `https://no-default/wiki/api/v2` - URL: `https://no-default/wiki/api/v2/databases/{id}/views` - Auth: one of: - HTTP basic - OAuth 2 - Authorization code: `https://auth.atlassian.com/authorize` - Token URL: `https://auth.atlassian.com/oauth/token` scopes: `read:database:confluence` Returns the views defined on a database using cursor-based pagination. Only view IDs, names, and types are returned; view configuration is not exposed. > **Consistency:** Responses may not immediately reflect recent changes. Clients requiring read-after-write confirmation should poll with bounded backoff. > **Experimental:** This operation is experimental and may change in backwards-incompatible ways without notice. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: Permission to view the database and its corresponding space. ## Path parameters - `id` string, required ## Query parameters - `limit` integer - `cursor` string ## Headers - `If-None-Match` string ## Response `200` Returned if the requested database views are returned. - DatabaseViewListResponse - `results` DatabaseView[], required - `id` string, required: Stable identifier of the view. - `name` string, required: User-visible view name. - `type` 'table' | 'gallery' | 'board' | 'calendar' | 'timeline', required - `_links` DatabasesPublicApiLinks, required: Links for a Databases API representation. `self` and `next` are path-only URLs. `base` is the absolute canonical Confluence site base URL. `next` is present only when another page exists. Additional future link relations may be added without a representation-version bump. - `self` string, required: Path-only URL of this resource or result page. - `base` string, uri, required: Absolute canonical site base URL, including the `/wiki` context path. - `next` string: Path-only URL of the next page. - `meta` DatabasePaginationMeta, required - `pageSize` integer, required: Requested page size used to produce this page. - `cursor` string: Cursor that produced this page; absent on the first page. - `hasMore` boolean, required: Whether another page exists after this page. ## Other responses - `304`: Returned without a body when `If-None-Match` matches the selected representation. A `304 Not Modified` means that the selected representation has not changed. It does not guarantee that a recent upstream write has finished propagating. A `304` for one endpoint, query, or page says nothing about any other representation. - `400`: Returned for invalid pagination input. `INVALID_CURSOR` means the token is malformed or structurally invalid. `UNSUPPORTED_CURSOR_VERSION` means it decoded successfully but uses an unsupported version. `CURSOR_QUERY_MISMATCH` means a well-formed cursor was issued for a different database, collection endpoint, filter, sort, or page size. `INVALID_PAGE_LIMIT` means `limit` is outside the documented syntax or range. Restart from the first page after a query-context mismatch. - `401`: Returned when authentication credentials are missing, invalid, or are not accepted for this operation. Only the HTTP status is part of the Databases contract. - `403`: Returned when an authenticated request is forbidden by an applicable app access or authorization policy. Only the HTTP status is part of the Databases contract. - `404`: Returned with `DATABASE_NOT_FOUND` when the database does not exist, cannot be returned, the feature is unavailable, or the caller lacks permission to view it. These cases are intentionally indistinguishable. - `413`: Returned with `DATABASE_TOO_LARGE` when the database exceeds a database-wide size limit evaluated before pagination or a serialized-response size limit. The error detail identifies the limit exceeded. Pagination, filtering, and a smaller limit do not bypass the database-wide limit. - `429`: Returned when the request is throttled by a service handling the request. This response does not guarantee a Databases error envelope or application error code. Clients must honor `Retry-After` when it is supplied. `RateLimit-Reason` is opaque limiter attribution; it and the legacy `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` headers are conditional. - `502`: Returned without a body when a dependent service returns `401` or `403`; when an upstream `5xx` response is unknown, malformed, untrusted, or not allowlisted; or when another dependent-service I/O failure occurs. - `503`: Returned with `SERVICE_DISABLED` when the requested operation is not currently available, or with `SERVICE_UNAVAILABLE` when a service handling the request or a required dependency is temporarily unavailable. Clients may retry `SERVICE_UNAVAILABLE`. `Retry-After` is conditional and may be omitted; clients must honor it when present. - `504`: Returned with `REQUEST_TIMEOUT` and a structured error when an allowlisted dependent-service response reports that the request timed out. A connection, socket, or proxy transport timeout is returned without a response body. ## Changes - **2026-10-13** `70db057b1a05`: 1 info - endpoint added [Operation history](https://skmtc.dev/atlassian/apis/the-confluence-cloud-rest-api-v2/changes/databases/:id/views/get.md) --- [API](https://skmtc.dev/atlassian/apis/the-confluence-cloud-rest-api-v2.md) - [All operations](https://skmtc.dev/atlassian/apis/the-confluence-cloud-rest-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/atlassian/apis/the-confluence-cloud-rest-api-v2/revisions/246e0eec8f43?raw)