# List knowledge pages

Launch stage: Beta

`GET /api/2.0/knowledge/pages`

List visible knowledge pages in the account, optionally narrowed by
 `domain` and `state`. With a domain filter, the caller must administer that
 domain, including through inherited grants. Without a domain filter,
 including when filtering only by state, account-wide Manage Discover or
 Account Admin permission is required. List returns page metadata.

API scopes: knowledge

## Query parameters

- `page_size` (int32, optional)
  Maximum number of pages to return, from 1 to 100. Defaults to 50 when omitted.
   The server may return fewer.
- `page_token` (string, optional)
  Opaque `next_page_token` from a previous ListPages response. Omit on the
   first request; pass it unchanged and keep the same filter when continuing.
- `filter` (string, optional)
  Filter clauses with double-quoted values, joined by uppercase `AND`.
   Each field may appear once:
   - `domain = "domains/{domain_id}"` includes that domain and its subdomains.
   - `state = "DRAFT"` or `state = "PUBLISHED"` matches that state exactly.
   For example: `domain = "domains/{domain_id}" AND state = "PUBLISHED"`.
   Other fields and operators are not supported. An omitted or blank filter
   lists visible pages across the account, subject to ListPages permissions.

## Returns

Returns a list of Page objects.

## Response

```json
{
  "pages": [
    {
      "name": "string",
      "domain": "string",
      "display_name": "string",
      "body": "string",
      "synonyms": [
        "string"
      ],
      "description": "string",
      "state": "DRAFT",
      "create_time": "string",
      "update_time": "string",
      "owner_ids": [
        "string"
      ]
    }
  ],
  "next_page_token": "string"
}
```