# List the Settings' Changes

Every change of the address book's settings asked for, newest first.

## Overview

- Each change names only the settings it changes (the others are `null`), whether it `lowers` a protection, its `status` — `pending`, `applied`, `rejected` or `withdrawn` —, who asked and who decided.
- `status` keeps one status; `limit` 1–100, default 20. One page: there is no cursor.
- For the roles that read the book.

## Endpoint

### `GET /v1/address-book/settings/changes`

Authentication: bearer token required.

The settings' changes, newest first.

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `status` | string | no | `pending`, `applied`, `rejected` or `withdrawn` |
| `limit` | integer | no | 1–100, default 20 |

**Responses**

`200` OK

```json
{
  "changes": [
    {
      "id": "5b0d3e92-7c1a-4e68-b4f9-0a2c6d8e1f37",
      "coolingPeriodSeconds": 3600,
      "proofRequired": null,
      "oneTimeAddresses": null,
      "lowers": true,
      "status": "pending",
      "requiredApprovals": 1,
      "requestedBy": "6a1c9e3f-2b7d-4f50-8e4a-0c5d3b9f7e12",
      "requestedScope": "tenant",
      "createdAt": "2026-10-08T09:05:00.000Z",
      "decidedBy": null,
      "decidedScope": null,
      "decidedAt": null
    }
  ]
}
```

---

Web version: https://docs.aureahub.com/#address-book-changes-list