---
title: "Get the stores of an account"
method: POST
path: "/getStoresUnderAccount"
tags: ["General"]
deprecated: true
---

# Get the stores of an account

`POST /getStoresUnderAccount`

> **Deprecated.**

Returns a list of stores associated with a company account or a merchant account, including the status of each store.

>From January 1, 2025 POS Terminal Management API is deprecated and support stops on April 1, 2025. To automate the management of your terminal fleet, use our [Management API](https://docs.adyen.com/api-explorer/Management/latest/overview).

## Request body

- GetStoresUnderAccountRequest
  - `companyAccount` string, required — The company account. If you only specify this parameter, the response includes the stores of all merchant accounts that are associated with the company account.
  - `merchantAccount` string — The merchant account. With this parameter, the response only includes the stores of the specified merchant account.

## Response `200`

OK - the request has succeeded.

- GetStoresUnderAccountResponse
  - `stores` Store[] — Array that returns a list of all stores for the specified merchant account, or for all merchant accounts under the company account.
    - `address` Address
      - `city` string
      - `countryCode` string
      - `postalCode` string
      - `stateOrProvince` string
      - `streetAddress` string
      - `streetAddress2` string
    - `description` string — The description of the store.
    - `inStoreTerminals` string[] — The list of terminals assigned to the store.
    - `merchantAccountCode` string — The code of the merchant account.
    - `status` string — The status of the store: - `PreActive`: the store has been created, but not yet activated. - `Active`: the store has been activated. This means you can process payments for this store. - `Inactive`: the store is currently not active. - `InactiveWithModifications`: the store is currently not active, but payment modifications such as refunds are possible. - `Closed`: the store has been closed.
    - `store` string, required — The code of the store.

## Other responses

- `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

- **2025-01-06** (v1) `9c22824cacf1` — 1 info
  - endpoint deprecated
- **2023-06-22** (v1) `6c089164bff1` — 1 info
  - the endpoint scheme security `BasicAuth` was added to the API
- **2023-03-07** (v1) `a1d5aadcf2a3` — 9 breaking
  - the request's body type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `200`
  - the response's body type changed from no type to `object` for status `400`
  - the response's body type changed from no type to `object` for status `401`
  - …5 more

[Change history](https://skmtc.dev/adyen/apis/pos-terminal-management-api-deprecated/changes/getStoresUnderAccount/post.md)

---

[API](https://skmtc.dev/adyen/apis/pos-terminal-management-api-deprecated.md) · [All operations](https://skmtc.dev/adyen/apis/pos-terminal-management-api-deprecated/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adyen/pos-terminal-management-api-deprecated/revisions/079660320468/schema)