# Address Book Settings

Your cooling period, whether external addresses are proven first, whether one-time addresses are allowed — and what your signing points do with the book.

## Overview

- `settings`: `coolingPeriodSeconds` (default `86400`), `proofRequired` and `oneTimeAddresses` (default `false`). `effectiveCoolingPeriodSeconds`: the period an approval given now starts — at least 24 hours on the institutional profile. `pendingChange`: the change waiting for its approval, or `null`.
- `mode`: what your tenant's signing points do with the book — `off` (nothing), `log` (every tenant's today: destinations outside the book recorded, nothing refused), `enforce` (refused: `403` `ADDRESS_BOOK_DESTINATION_NOT_ALLOWED`; [Coming soon, upon request](https://docs.aureahub.com/docs/feature-availability.md)). `enforced`: your tenant refuses such destinations. [At the Signing Points](https://docs.aureahub.com/docs/guide-address-book.md).
- For the roles that read the book.

## Endpoint

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

Authentication: bearer token required.

Your address book's settings and mode.

**Responses**

`200` OK

```json
{
  "mode": "off",
  "enforced": false,
  "settings": {
    "coolingPeriodSeconds": 86400,
    "proofRequired": false,
    "oneTimeAddresses": false
  },
  "effectiveCoolingPeriodSeconds": 86400,
  "pendingChange": null
}
```

**Example request**

```bash
curl https://api.aureahub.com/v1/address-book/settings \
  -H "Authorization: Bearer $TOKEN"
```

---

Web version: https://docs.aureahub.com/#address-book-settings-get