---
title: "aid_account_management_stores_get"
method: GET
path: "/accounts/{aid}/stores"
tags: ["account-stores"]
---

# aid_account_management_stores_get

`GET /accounts/{aid}/stores`

Get details about the account stores

scopes:
- admin:accounts
- read:accounts

## Path parameters

- `aid` string, ^[PT]{1}\d{8}$, required

## Query parameters

- `payout_destination_id` string[]
- `terminal_id` string[]
- `includes` string[]
- `status` string[]
- `starting_after` string
- `limit` integer

## Response `200`

List of stores

- StoreCollection
  - `starting_after` string
  - `stores` object[], required
    - `terminals_summary` StoreTerminalSummary[] — Summary of terminals for this store.
      - `status` 'DELETED' | 'PENDING' | 'ACTION_REQUIRED' | 'ACTIVE' | 'INACTIVE' | 'ERROR', required — The status of the terminal
      - `count` integer, required — Number of terminals with this status
    - `organization` object, required — The organization for the store
      - `organization_number` string, required
      - `country` string — ISO 3166-1 country code for the organization number
      - `type` 'main_unit' | 'sub_unit'
      - `name` string
      - `trade_name` string
    - `store_name` string, required
    - `email` string, email
    - `phone_number` string, E.164, required — A phone number in E.164 format
    - `address` object
      - `address_line` string, required
      - `address_line_2` string
      - `postal_code` string, required
      - `postal_place` string, required
      - `country` string, iso-3166-1, required — ISO 3166-1 country code
    - `coordinates` object — The coordinates of the store
      - `latitude` number, float, required
      - `longitude` number, float, required
    - `website` string
    - `payout_destination` object — The payout destination associated with this store. A store with a payout destination will get all its properties (address, phone_number +++) set by validated data so you will not be allowed to set custom address when payout destination is set The organization_number must match the organization number of the payout destination These exceptions do not apply to payout destination's sub-units where different sub-unit organization_number is allowed and the details will be set by what is available in the public registers.
      - `payout_destination_id` string, required
      - `merchant_category_code` string, mcc
      - `status` 'ACTIVE' | 'DECLINED' | 'UNDER_MANUAL_REVIEW' | 'AUTOMATIC_REVIEW' | 'WAITING_FOR_SIGNATURE' | 'WAITING_FOR_DECLARATION' | 'ERROR' | 'ARCHIVED' | 'WAITING_FOR_DETAILS' | 'TERMINATED', required
      - `type` 'company' | 'individual', required — - For a company seller select `company` or leave blank. Required fields are `organization_number` and `country_code`. - For an individual seller select `individual`. Provide optional fields in the individual object.
    - `store_id` string, required — Client-supplied store identifier. If omitted, the server generates one (e.g. T12345678-0001) and uses it as the store_id.
    - `id` string, required
    - `created_at` string, required
    - `created_by` string, required
    - `updated_at` string, required
    - `updated_by` string, required
    - `status` 'ACTIVE' | 'PENDING' | 'SUSPENDED' | 'DELETED' | 'ERROR', required
    - `verified` boolean, required — The store data have been verified
    - `number_of_terminals` integer, required — Number of terminals associated with a store
    - `operator_payout_destinations` OperatorPayoutDestination[] — Operator destinations associated with this store. Included when includes=operator_payout_destinations is used.
      - `payout_destination_id` string, required — The unique identifier of the payout destination
      - `organization_number` string — National organization number valid in the country specified
      - `name` string — The name of the organization
      - `trade_name` string — The trade name of the organization
      - `merchant_category_code` string, mcc
      - `status` 'ACTIVE' | 'DECLINED' | 'UNDER_MANUAL_REVIEW' | 'AUTOMATIC_REVIEW' | 'WAITING_FOR_SIGNATURE' | 'WAITING_FOR_DECLARATION' | 'ERROR' | 'ARCHIVED' | 'WAITING_FOR_DETAILS' | 'TERMINATED', required
      - `type` 'company' | 'individual', required — - For a company seller select `company` or leave blank. Required fields are `organization_number` and `country_code`. - For an individual seller select `individual`. Provide optional fields in the individual object.

## Other responses

- `400` — Bad / Invalid request
- `401` — Access forbidden, invalid JWT token was used
- `403` — Forbidden
- `500` — Unexpected Error

---

[API](https://skmtc.net/dintero/apis/account-management-api.md) · [All operations](https://skmtc.net/dintero/apis/account-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dintero/account-management-api/revisions/9b83a4199008/schema)