# Get an Address Book Entry

One entry, with everything that happened to it.

## Overview

- The entry as [List Entries](https://docs.aureahub.com/docs/address-book-entries-list.md) shows it, plus `history`, oldest first: each move's `version`, `event` (`requested`, `address_changed`, `changed`, `approved`, `activated`, `rejected`, `removed`, `proven`), `fromStatus` and `toStatus`, that version's `address`, `network` and `chain`, who made it (`actorKind` `user` or `system`, `actorId`, `actorRole`, `scope`) and `at`.
- `status` is the entry's status now; `coolingSecondsLeft` counts down while it cools. `404` `ADDRESS_BOOK_ENTRY_NOT_FOUND` for an entry that is not your tenant's.
- The example is an external entry of a tenant that requires a proof: asked for (`requested`, waiting in `pending_approval`), then proven, which started its cooling (`proven` → `cooling`). Where no proof is required, `requested` goes straight to `cooling`.

## Endpoint

### `GET /v1/address-book/entries/{entryId}`

Authentication: bearer token required.

One entry with its history.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `entryId` | string (uuid) | yes | The entry's id |

**Responses**

`200` OK

```json
{
  "id": "8f3c2a71-5d4e-4b9a-a6c1-2e7f9d0b3c58",
  "accountId": null,
  "kind": "external",
  "family": "evm",
  "network": "mainnet",
  "chain": "base",
  "chainId": null,
  "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
  "walletId": null,
  "label": "Supplier payouts",
  "tags": ["suppliers"],
  "customerRefId": "SUP-0042",
  "status": "cooling",
  "version": 1,
  "requestedBy": "0d2f6b8a-4c1e-4a93-b7d5-2e9f1c3a8b60",
  "requestedScope": "tenant",
  "requestedAt": "2026-10-08T08:00:12.000Z",
  "approval": {
    "approvedBy": null,
    "approvedScope": "tenant",
    "approvedAt": "2026-10-08T08:10:41.000Z",
    "requiredApprovals": 0
  },
  "coolingPeriodSeconds": 86400,
  "activeAt": "2026-10-09T08:10:41.000Z",
  "coolingSecondsLeft": 51041,
  "proof": { "proven": true, "method": "eip191", "provenAt": "2026-10-08T08:10:41.000Z" },
  "rejectedBy": null,
  "rejectedAt": null,
  "removedBy": null,
  "removedAt": null,
  "createdAt": "2026-10-08T08:00:12.000Z",
  "updatedAt": "2026-10-08T08:10:41.000Z",
  "history": [
    { "version": 1, "event": "requested", "fromStatus": null, "toStatus": "pending_approval", "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed", "network": "mainnet", "chain": "base", "actorKind": "user", "actorId": "0d2f6b8a-4c1e-4a93-b7d5-2e9f1c3a8b60", "actorRole": "editor", "scope": "tenant", "at": "2026-10-08T08:00:12.000Z" },
    { "version": 1, "event": "proven", "fromStatus": "pending_approval", "toStatus": "cooling", "address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed", "network": "mainnet", "chain": "base", "actorKind": "user", "actorId": "0d2f6b8a-4c1e-4a93-b7d5-2e9f1c3a8b60", "actorRole": "editor", "scope": "tenant", "at": "2026-10-08T08:10:41.000Z" }
  ]
}
```

`404` Not found

```json
{
  "statusCode": 404,
  "error": "NotFoundError",
  "message": "Address book entry not found",
  "details": { "code": "ADDRESS_BOOK_ENTRY_NOT_FOUND" }
}
```

---

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