The Merchants API groups individual seller locations into larger organizations, allowing them to operate as a single entity. Each merchant represents one organization or business that sells with Square and all team members of that business can coordinate on behalf of the merchant.
When a Square seller connects to your application with OAuth or a personal access token, your application receives an access token that is scoped to that merchant group. Use the Merchants API to retrieve core information about the organization connecting to your application, such as the language preferences, business name, country, and account status.
In the Square data model, the access token (OAuth or PAT) used to connect your application to a Square seller is associated with a single merchant. Use this merchant's ID in the request URL for the RetrieveMerchant endpoint to access information about the merchant.
The following is an example response:
Alternatively, you can request the specific merchant associated with your account's access tokens by calling RetrieveMerchant using
me in place of the merchant ID.
You can also retrieve the associated merchant using the ListMerchants endpoint.
Note that the response is in the form of a list, but contains only one merchant: the one associated with your application based on the given access token.