v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-131362831.1 MB
Account - store level

Get a list of stores

Returns a list of stores for the merchant account identified in the path. The list is grouped into pages as defined by the query parameters.

To make this request, your API credential must have one of the following roles:

  • Management API—Stores read
  • Management API—Stores read and write

In the live environment, requests to this endpoint are subject to rate limits.

get/merchants/{merchantId}/stores

Path parameters

merchantIdstring required

The unique identifier of the merchant account.

Query parameters

pageNumberinteger

The number of the page to fetch.

pageSizeinteger

The number of items to have on a page, maximum 100. The default is 10 items on a page.

referencestring

The reference of the store.

Response

OK - the request has succeeded.

itemsTotalinteger required

Total number of items.

pagesTotalinteger required

Total number of pages.