get
https://api.lirium-sandbox.com/v1/customers//address_book
Retrieve a customer's address book entries and suggestions.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Returns all address book entries for a customer, split into two lists: saved entries (address_book) and system-generated suggestions (suggestion) based on past transaction history.
Request
GET /customers/{customer_id}/address_book
Response Fields
The response contains two arrays:
address_book — Addresses explicitly saved by the customer or partner.
suggestion — Addresses derived from the customer's transaction history that haven't been explicitly saved.
Both arrays contain objects with the same fields:
| Field | Type | Description | Example |
|---|---|---|---|
| id | string | Unique identifier for the entry | "ewteqwtqewtqwetqwetqwetq" |
| address | string | The cryptocurrency address | "bc1qmv4pr0hs4gd3s7chgacccr3m9ajf7xdcf7mfrm" |
| network | string | The blockchain network | "bitcoin" |
| label | string | null | A friendly label for the address | "my bitcoin address" |
| created | string | ISO 8601 creation timestamp | "2021-01-25T20:38:31+00:00" |
| last_used | string | null | ISO 8601 timestamp of last use | null |
| ownership_type | string | null | Ownership relationship: self or third_party | "self" |
| beneficiary_full_name | string | null | Full name of the beneficiary when ownership_type is third_party | null |
Error Responses
| Status | Error Code | Description |
|---|---|---|
| 400 | invalid_parameters | Request validation failed |
| 404 | not_found | Customer not found |