---
title: "Get a store"
method: GET
path: "/merchants/{merchantId}/stores/{storeId}"
tags: ["Account - store level"]
---

# Get a store

`GET /merchants/{merchantId}/stores/{storeId}`

## Request

- Base URL: `https://management-test.adyen.com/v3`
- URL: `https://management-test.adyen.com/v3/merchants/{merchantId}/stores/{storeId}`
- Auth: one of:
  - HTTP basic
  - API key in header `X-API-Key`

Returns the details of the store identified in the path.

To make this request, your API credential must have one of the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions):
* Management API—Stores read
* Management API—Stores read and write

In the live environment, requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment).

## Path parameters

- `merchantId` string, required
- `storeId` string, required

## Response `200`

OK - the request has succeeded.

- Store
  - `_links` Links
    - `self` LinksElement, required
      - `href` string
  - `address` StoreLocation
    - `city` string: The name of the city.
    - `country` string, required: The two-letter country code in [ISO_3166-1_alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
    - `line1` string: The street address.
    - `line2` string: Second address line.
    - `line3` string: Third address line.
    - `postalCode` string: The postal code.
    - `stateOrProvince` string: The state or province code as defined in [ISO 3166-2](https://www.iso.org/standard/72483.html). For example, **ON** for Ontario, Canada. Required for the following countries: - Australia - Brazil - Canada - India - Mexico - New Zealand - United States
  - `businessLineIds` string[]: The unique identifiers of the [business lines](https://docs.adyen.com/api-explorer/#/legalentity/latest/post/businesslines__resParam_id) that the store is associated with. If not specified, the business line of the merchant account is used. Required when there are multiple business lines under the merchant account.
  - `description` string: The description of the store.
  - `externalReferenceId` string: The unique identifier of the store, used by certain payment methods and tax authorities. Required for CNPJ in Brazil, in the format 00.000.000/0000-00 separated by dots, slashes, hyphens, or without separators. Optional for SIRET in France, up to 14 digits. Optional for Zip in Australia, up to 50 digits.
  - `id` string: The unique identifier of the store. This value is generated by Adyen.
  - `localizedInformation` LocalizedInformation
    - `localShopperStatement` LocalShopperStatement[], required: An array of local shopper statements. Card schemes use this in the bank statement. For Japan local shopper statements in both ja-Hani and ja-Kana are required.
      - `script` string, required: The character set of the local shopper statement. Possible values: **ja-Hani**, **ja-Kana**.
      - `value` string, required: The text of the local shopper statement in the specified character set.
  - `merchantId` string: The unique identifier of the merchant account that the store belongs to.
  - `phoneNumber` string: The phone number of the store, including '+' and country code in the [E.164](https://en.wikipedia.org/wiki/E.164) format. If passed in a different format, we convert and validate the phone number against E.164.
  - `reference` string: A reference to recognize the store by. Also known as the store code. Allowed characters: lowercase and uppercase letters without diacritics, numbers 0 through 9, hyphen (-), and underscore (_)
  - `shopperStatement` string: The store name shown on the shopper's bank or credit card statement and on the shopper receipt.
  - `splitConfiguration` StoreSplitConfiguration
    - `balanceAccountId` string: The [unique identifier of the balance account](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/get/balanceAccounts/{id}__queryParam_id) to which the split amount must be booked, depending on the defined [split logic](https://docs.adyen.com/api-explorer/Management/latest/post/merchants/_merchantId_/splitConfigurations#request-rules-splitLogic).
    - `splitConfigurationId` string: The unique identifier of the [split configuration profile](https://docs.adyen.com/platforms/automatic-split-configuration/create-split-configuration/).
  - `status` 'active' | 'closed' | 'inactive': The status of the store. Possible values are: - **active**. This value is assigned automatically when a store is created. - **inactive**. The terminals under the store are blocked from accepting new transactions, but capturing outstanding transactions is still possible. - **closed**. This status is irreversible. The terminals under the store are reassigned to the merchant inventory.
  - `subMerchantData` SubMerchantData
    - `email` string, required: The email associated with the sub-merchant's account.
    - `id` string, required: A unique identifier that you create for the sub-merchant, used by schemes to identify the sub-merchant. * Format: Alphanumeric * Maximum length: 15 characters
    - `mcc` string, required: The sub-merchant's 4-digit Merchant Category Code (MCC). * Format: Numeric * Fixed length: 4 digits
    - `name` string, required: The name of the sub-merchant. Based on scheme specifications, this value will overwrite the shopper statement that will appear in the card statement. * Format: Alphanumeric * Maximum length: 22 characters

## Other responses

- `204`: No Content - the request has been successfully processed, but there is no additional content.
- `400`: Bad Request - a problem reading or understanding the request.
- `401`: Unauthorized - authentication required.
- `403`: Forbidden - insufficient permissions to process the request.
- `422`: Unprocessable Entity - a request validation error.
- `500`: Internal Server Error - the server could not process the request.

## Changes

- **2026-01-28** (v3) `cb9770d903d0`: 1 info
  - added the optional property `localizedInformation` to the response with the `200` status
- **2025-06-05** (v3) `7648db985641`: 1 info
  - added the optional property `subMerchantData` to the response with the `200` status

[Operation history](https://skmtc.dev/adyen/apis/management-api/changes/merchants/:merchantId/stores/:storeId/get.md)

---

[API](https://skmtc.dev/adyen/apis/management-api.md) - [All operations](https://skmtc.dev/adyen/apis/management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adyen/apis/management-api/revisions/55cb8143ce0e?raw)