---
title: "Get matched merchant information for a given card acceptor id"
method: GET
path: "/merchants-by-card-acceptor-ids"
tags: ["Merchants"]
---

# Get matched merchant information for a given card acceptor id

`GET /merchants-by-card-acceptor-ids`

## Request

- Base URL: `https://api.mastercard.com/merchant-identifier`
- URL: `https://api.mastercard.com/merchant-identifier/merchants-by-card-acceptor-ids`
- Auth: none declared
- TypeScript: <https://skmtc.dev/mastercard/apis/merchant-identifier-api/docs/merchants-by-card-acceptor-ids/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns merchant details for matched merchants given a card acceptor id and optional country code.  (IMPORTANT - Only card acceptor ids that can be uniquely mapped to one merchant location are accepted)

## Query parameters

- `card_acceptor_id` string, required
- `country_code` string

## Response `200`

Information for this merchant identifier

- MerchantByCardAcceptorIdList: List of merchants
  - `merchants` MerchantByCardAcceptorId[]: merchants
    - `address` Address: Available information for this Address such as the street, city, country, country subdivision an postal code.
      - `city` string: Name of the city or town where the merchant is located
      - `country` Country: Available information the Country such as the name and code
        - `code` string: Three digit alpha country code as defined in ISO 3166-1
        - `name` string: Name of the country
      - `countrySubdivision` CountrySubDivision: Available information the Country Subdivision such as the name and code
        - `code` string: Abbreviated code for the state or province
        - `name` string: Name of the state or province
      - `line1` string: Line 1 of the street address of the merchant. Usually includes the street number and name
      - `line2` string: Line 2 of the street address, usually an apartment number or suite number
      - `postalCode` string: The zip code or postal code for a merchant
    - `brandName` string: The brand name of the merchant
    - `cardAcceptorId` string: The Card Acceptor ID assigned by the acquirer
    - `legalCorporateName` string: Corporate legal name of the merchant
    - `locationId` integer: Merchant specific location identifier
    - `merchantCategory` string: Merchant category code and description associated with the merchant category code for the merchant
    - `merchantDbaName` string: The business name of the merchant
    - `phoneNumber` string: The phone number of the merchant
    - `isBrickAndMortar` boolean: Indicates whether the input descriptor is used by the merchant for brick-and-mortar (card-present) transactions
    - `isEcommerce` boolean: Indicates whether the input descriptor is used by the merchant for e-commerce (card-not-present) transactions

## Other responses

- `400`: Something was wrong with the request.
- `401`: Authentication information was missing or invalid.
- `403`: Insufficient permissions for interacting with the resource.

---

[API](https://skmtc.dev/mastercard/apis/merchant-identifier-api.md) - [All operations](https://skmtc.dev/mastercard/apis/merchant-identifier-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mastercard/apis/merchant-identifier-api/revisions/9cf3031bbd2e?raw)