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

# Get merchant information for a given tax id

`GET /merchants-by-tax-ids`

## Request

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

Returns a list merchants details for matched merchant given a tax id

## Query parameters

- `tax_id` string, required
- `country_code` string, required

## Response `200`

Information for this merchant identifier

- MerchantByTaxIdList: List of merchants
  - `merchants` MerchantByTaxId[]: 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
    - `taxId` string: The tax id assigned by government entity for location
    - `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

## 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)