Get Checkout Addresses

Retrieve guest / the authenticated customer's checkout saved addresses so they can select one as their shipping or billing address during checkout. This endpoint returns previously saved addresses — it does not create new ones.

Endpoint

GET /api/shop/checkout/addresses

Request Headers

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

Response Fields (200 OK)

Field	Type	Description
addresses	array	List of customer addresses
defaultShippingId	integer	ID of default shipping address
defaultBillingId	integer	ID of default billing address

Address Fields

Field	Type	Description
id	integer	Address ID
firstName	string	First name
lastName	string	Last name
email	string	Email address
address	string	Street address
city	string	City
state	string	State/Province
country	string	Country code
postcode	string	Postal code
phone	string	Phone number

Use Cases

• Populate shipping address dropdown
• Populate billing address dropdown
• Show saved addresses in checkout
• Allow address selection during checkout
• Set default addresses

Related Resources

• Set Shipping Address
• Set Billing Address
• Get Shipping Methods

Fetching Customer Addresses

To retrieve the full list of a customer's saved addresses (outside of checkout), use the dedicated customer address queries:

• GraphQL: Get Customer Addresses
• REST: Get Customer Addresses