# Merchant Names Search
source: https://developer.mastercard.com/locations-merchants/documentation/use-cases/merchant-name/index.md

## Merchant Names Search {#merchant-names-search}

This API allows customers to retrieve a list of merchant names for various **Merchant** types like '**paypass** ', '**easysavings** ', and '**cashback** ' based on a provided partial merchant name. In this example, we will search for '**paypass**' merchants with the keyword 'Pizza'.
Diagram sequence-merchant-names

**Example Response:**

```json
{
  "count": 100,
  "limit": 100,
  "offset": 1000,
  "searchedMerchantName": "Pizza",
  "merchantType": "PAYPASS",
  "merchantNames": [
    "BEAMER'S A1 PIZZA",
    "BEANOS PIZZA",
    ...
    "BEST CHOICE PIZZA 2 FOR 1",
    "BEST CITY PIZZA",
    "BEST FAMOUS PIZZA"
  ]
}
```

## Relevant Endpoints {#relevant-endpoints}

[Find Merchant Names](https://developer.mastercard.com/locations-merchants/documentation/api-reference/index.md#tag/Merchants/operation/getMerchantNames)
Returns a list of merchant names based on the merchant name or partial merchant name provided by the customer

API Reference: `GET /merchants-names`

## Useful Links {#useful-links}

* [View the full Open API Specification](https://developer.mastercard.com/locations-merchants/documentation/api-reference/index.md)
* [Review the API's error responses](https://developer.mastercard.com/locations-merchants/documentation/code-and-formats/index.md)