Get Checkout Addresses

Retrieve the address associated with the current checkout session.

This query returns only the address applied to the active checkout — the one entered during guest checkout, or the one the signed-in customer selected for this order. It is not the customer's address book; read that with Get Customer Addresses.

Authentication

This query supports both authenticated customers and guest users:

• Authenticated customers: Provide a valid customer authentication token in the Authorization header. Obtain this token via the Customer Login API.
• Guest users: Provide the Guest Cart Token cartToken obtained from the Create Cart mutation.

Authorization: Bearer <accessToken>

Response

Field	Type	Description
id	String	Address ID
addressType	String	Type of address (billing or shipping)
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/Zip code
email	String	Email address
phone	String	Phone number
useForShipping	Boolean	Whether this address is also used for shipping
defaultAddress	Boolean	Whether this is the customer's default address
createdAt	DateTime	When address was created

Use Cases

• Confirm the address applied to the current checkout session
• Display the selected address on the order review/summary page
• Verify guest checkout address before placing the order

Related Documentation

• Get Customer Addresses
• Set Checkout Address
• Set Billing Address