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

200200

400400