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

# Get the stores of an account

`POST /getStoresUnderAccount`

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

## 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.

---

[API](https://skmtc.net/adyen/apis/tfmapiservice.md) · [All operations](https://skmtc.net/adyen/apis/tfmapiservice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/tfmapiservice/versions/4c0e71faa937/schema)