# Get Shipping Addresses
source: https://developer.mastercard.com/digital-redemptions/documentation/use-cases/redemptions/get-shipping-addresses/index.md

## Overview {#overview}

This use case provides the ability to retrieve existing customer shipping addresses. Shipping addresses are returned if they are associated with a redemption transaction that has occurred in the last 160 days.

## Sequence diagram {#sequence-diagram}

Diagram get-shipping-addresses

##### Following are the execution steps: {#following-are-the-execution-steps}

1. The consumer signs into the customer application.
2. The customer authenticates the consumer.
3. The customer sends a signed request to the Digital Redemptions for retrieving shipping addresses used by the cardholder within the requested dates up to maximum of 160 days in the past.

* The request for retrieving shipping address requires the following mandatory request parameters:
  * **user_id** : The identifier used to uniquely identify an user.
  * **user_id_type** : Type of the user or account identification. Supported identifier is RANCU.

4. Mastercard Network API Gateway authenticates/authorizes the customer and routes the request to the Digital Redemptions in the case of a valid customer.
5. The Digital Redemptions Service validates the request parameters received via the `GET /redemptions/addresses` endpoint.
6. The Digital Redemptions Service retrieves the shipping addresses.
7. The Digital Redemptions Service sends a response with shipping addresses used by the cardholder within the requested dates up to maximum of 160 days in the past (200).
8. The Digital Redemptions Service sends a response with a status code of 4xx/5xx in case of an invalid request.

You will receive an error response for an invalid request or any missing request parameter. In that case, you need to update the input and perform step 3 again.

## Endpoint {#endpoint}


API Reference: `GET /redemptions/addresses`