List Database Views

Use Case

Use this endpoint to enumerate all views of a database (table, board, gallery, and so on), confirm view IDs, or compare filters and column layouts across views. The list follows the product's view order and only includes views that are not archived.

Endpoint

Permissions

Requires databases.read and read access to the database.

Parameters

Response Example

{
  "object": "list",
  "results": [
    {
      "object": "database_view",
      "id": "34343434-3434-4343-8343-343434343434",
      "database_id": "66666666-6666-4666-8666-666666666666",
      "title": "In progress",
      "type": "table",
      "property_layout": [
        { "property_id": "title", "property_name": "Name", "visible": true, "width": 260 },
        {
          "property_id": "88888888-8888-4888-8888-888888888888",
          "property_name": "Status",
          "visible": true
        }
      ],
      "filter": {
        "type": "group",
        "operator": "and",
        "filters": [
          {
            "type": "filter",
            "property": "88888888-8888-4888-8888-888888888888",
            "operator": "eq",
            "value": "<option_id>",
            "propertyType": "select"
          }
        ]
      },
      "sorts": [{ "property": "title", "direction": "asc" }],
      "group_by": {
        "property_id": "88888888-8888-4888-8888-888888888888",
        "hide_empty_groups": true
      },
      "config": { "wrap": true, "freeze_column_index": 1 },
      "created_time": "2026-04-09T08:00:00.000Z",
      "last_edited_time": "2026-04-09T09:30:00.000Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

List responses omit page_sort (the manual order can be large); call Get Database View for the detail projection.

Behavior

• property_layout is the ordered column layout. property_id is the exact database schema property id; legacy databases may use a non-title id for the title property. Read responses include a read-only property_name convenience field that is ignored on write. Layout writes still accept the literal title as a compatibility alias when the schema has no exact title key.
• filter / sorts match the structure saved by the web client (see Get Database View); select values are returned as option ids, and references to deleted properties are pruned on read.
• group_by is only supported by table and board views; other types always return null.
• config is the curated per-type config projection described in the detail endpoint.

Errors