You are viewing an old version of the API
List 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 endpoint to get the merchant information.

Required permissions MERCHANT_PROFILE_READ

Query Parameters

Name Description
cursor
integer

The cursor generated by the previous response.

Response Fields

Name Description
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.

merchant
Merchant [ ]

The requested Merchant entities.

Examples

You are viewing an old version of the API
GET /v2/merchants
cURL
  • cURL
  • Ruby
  • Python
curl https://connect.squareup.com/v2/merchants \
  -H 'Square-Version: 2019-11-20' \
  -H 'Authorization: Bearer ACCESS_TOKEN'
Response JSON
{
  "merchants": [
    {
      "id": "DM7VKY8Q63GNP",
      "business_name": "Apple A Day",
      "country": "US",
      "language_code": "en-US",
      "currency": "USD",
      "status": "ACTIVE"
    }
  ]
}

Share Feedback

Thanks for visiting the Square API documentation. What's on your mind?