---
title: "List settings pages"
url: https://docs.gleap.ai/en/reference/rest-api/get-setting-pages
method: GET
path: "/settings/pages"
api: "API Reference"
tag: "Settings"
operationId: "GetSettingPages"
updatedAt: "2026-11-01T18:40:15.677Z"
language: en
---

# List settings pages

`GET https://api.gleap.io/v3/settings/pages`

The settings pages you may see, with each field's key, type, allowed values and whether a change needs your confirmation. Secrets (keys, tokens, signing secrets) are never returned.

## Authorization

- `Authorization` (header, required): `Bearer <token>`

## Headers

- `project` (string, required)

## Example request

```bash
curl --request GET \
  --url https://api.gleap.io/v3/settings/pages \
  --header 'Authorization: Bearer <token>' \
  --header 'project: <project>'
```

## Responses

### 200 (`application/json`)

Ok

- `pages` (object[], required)
  - `canChange` (boolean, required)
  - `description` (string, required)
  - `path` (string, required)
  - `name` (string, required)
  - `key` (string, required)
  - `whyNot` (any)
  - `items` (object)
    - `ops` (string[], required)
    - `nameKey` (string, required)
  - `perSite` (boolean)
  - `fields` (object[], required)
    - `description` (string, required)
    - `type` (enum<string>, required): One of: `boolean`, `string`, `text`, `number`, `enum`, `color`, `url`, `stringList`, `json`.
    - `label` (string, required)
    - `key` (string, required)
    - `values` (string[])
    - `min` (number<double>)
    - `max` (number<double>)
    - `needsConfirmation` (string)
    - `secret` (boolean)
    - `readOnly` (boolean)
  - `notCovered` (string)
- `notForYou` (object[])
  - `whyNot` (string, required)
  - `name` (string, required)
  - `key` (string, required)

```json
{
  "pages": [
    {
      "canChange": true,
      "description": "string",
      "path": "string",
      "name": "string",
      "key": "string",
      "items": {
        "ops": [
          "string"
        ],
        "nameKey": "string"
      },
      "perSite": true,
      "fields": [
        {
          "description": "string",
          "type": "boolean",
          "label": "string",
          "key": "string",
          "values": [
            "string"
          ],
          "min": 0,
          "max": 0,
          "needsConfirmation": "string",
          "secret": true,
          "readOnly": true
        }
      ],
      "notCovered": "string"
    }
  ],
  "notForYou": [
    {
      "whyNot": "string",
      "name": "string",
      "key": "string"
    }
  ]
}
```