Get Customer Addresses

Retrieve all saved addresses for the authenticated customer.

Endpoint

GET /api/shop/customer-addresses

Request Headers

Header	Required	Description
X-STOREFRONT-KEY	Yes	Your storefront API key
Authorization	Yes	Bearer token (customer login required)

Query Parameters

Parameter	Required	Default	Description
sort	No	id	Column to sort by — id or created_at. The compound form created_at-desc (<column>-<direction>) is also accepted.
order	No	asc	Sort direction — asc or desc. Use desc to return the most recently added addresses first.

By default addresses are returned oldest-first (the order they were added). To show the newest address at the top, pass ?sort=created_at&order=desc (or the shorthand ?sort=created_at-desc).

Response Fields (200 OK)

Field	Type	Description
addresses	array	List of customer addresses

Address Fields

Field	Type	Description
id	integer	Address ID
firstName	string	First name
lastName	string	Last name
address	string	Street address
city	string	City
state	string	State/Province
country	string	Country code
postcode	string	Postal code
phone	string	Phone number
isDefault	boolean	Is default address
addressType	string	Type (residential/commercial)

Use Cases

• Display saved addresses in checkout
• Allow customer to select address
• Populate address dropdown
• Show customer's address book
• Select shipping address
• Select billing address

Related Resources

• Create Customer Address
• Update Customer Address
• Delete Customer Address