---
title: "ListMerchants"
method: GET
path: "/v2/merchants"
tags: ["Merchants"]
---

# ListMerchants

`GET /v2/merchants`

Returns `Merchant` information for a given access token.

If you don't know a `Merchant` ID, you can use this endpoint to retrieve the merchant ID for an access token.
You can specify your personal access token to get your own merchant information or specify an OAuth token
to get the information for the  merchant that granted you access.

If you know the merchant ID, you can also use the [RetrieveMerchant](https://developer.squareup.com/reference/square_2021-08-18/merchants-api/retrieve-merchant)
endpoint to get the merchant information.

## Query parameters

- `cursor` integer

## Response `200`

Success

- ListMerchantsResponse — The response object returned by the [ListMerchant](https://developer.squareup.com/reference/square_2021-08-18/merchants-api/list-merchants) endpoint.
  - `cursor` integer — If the response is truncated, the cursor to use in next request to fetch next set of objects.
  - `errors` Error[] — Information on errors encountered during the request.
    - `category` string, required — The high-level category for the error.
    - `code` string, required — The specific code of the error.
    - `detail` string — A human-readable description of the error for debugging purposes.
    - `field` string — The name of the field provided in the original request (if any) that the error pertains to.
  - `merchant` Merchant[] — The requested `Merchant` entities.
    - `business_name` string — The business name of the merchant.
    - `country` string, required — The country code associated with the merchant account, in ISO 3166 format.
    - `currency` string — The currency associated with the merchant account, in ISO 4217 format.
    - `id` string — The Square-issued ID of the merchant.
    - `language_code` string — The language code associated with the merchant account, in BCP 47 format.
    - `main_location_id` string — The ID of the main `Location` for this merchant.
    - `status` string — The merchant status, active or inactive.

---

[API](https://skmtc.net/square/apis/squareup.md) · [All operations](https://skmtc.net/square/apis/squareup/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/square/squareup/revisions/8d95e3639487/schema)