# Retrieve Merchants
source: https://developer.mastercard.com/priceless-specials/documentation/use-cases/retrieve-merchants/index.md

The Retrieve Merchants service allows the issuer to retrieve available merchants on the Priceless Specials API.

Upon successful request for retrieval of the merchants, the issuer may use the merchant information to further fine-tune their requests for offers, programs, or benefits from the Priceless Specials API.

## Pre-requisites {#pre-requisites}

Before using the Priceless Specials API service, your project must first be created as an API project on the Mastercard Developers.

## Sequence diagram {#sequence-diagram}

The following sequence diagram shows the order of events for a solution that uses the `/merchants` endpoint.
Diagram retrieve-merchants-new

Following are the execution steps:

1. The cardholder logs into the issuer mobile application or website to access information.
2. The issuer application sends a request to the issuer server.
3. The issuer server sends a request to the `/merchants` endpoint.
4. Mastercard authenticates the API request.
5. After successful authentication, the Priceless Specials API returns a JSON response with the list of available merchants and their relevant details.
6. The issuer server sends the available merchants information to the issuer application.
7. The issuer application displays the available merchants information to the cardholder.

## Endpoint {#endpoint}


API Reference: `GET /merchants`