# List Pages

`GET /pages`

Returns non-deleted pages the caller can access, ordered by most recently updated. Use `parentId` to list pages directly inside a folder, and follow `nextCursor` until it is `null`.
## Authentication

Use one of the following authentication alternatives:

- **API token** (`bearerToken`) : Send a named API token in the Authorization header. Send it in the `Authorization: Bearer <token>` header.
- **Better Auth browser session** (`browserSession`) : Use the Better Auth session cookie from a signed-in browser session. Send it in the `better-auth.session_token` cookie.
## Token permissions

API tokens must include `pages:read`.
## Parameters

- `cursor` (query, optional): Cursor returned by a previous list response.
- `limit` (query, optional): Number of pages to return. Defaults to 50 and cannot exceed 100.
- `parentId` (query, optional): Return only pages directly inside this folder.
## Responses

### 200

A page of accessible pages and the cursor for the next page.


### `application/json`

```json
{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "parentId": "00000000-0000-0000-0000-000000000000",
      "title": "string",
      "icon": "string",
      "cover": {
        "type": "string",
        "value": "string"
      },
      "properties": {},
      "ownerId": "00000000-0000-0000-0000-000000000000",
      "permission": "view",
      "createdAt": "string",
      "updatedAt": "string"
    }
  ],
  "nextCursor": "string"
}
```

### 403

The API token is missing a required scope: pages:read.


### `application/json`

```json
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
```