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

# aid_account_management_terminals_get

`GET /accounts/{aid}/terminals`

List terminals for the account. Filter by store, payout destination,
status, device model, or serial number.

scopes:
- admin:accounts
- read:accounts

## Path parameters

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

## Query parameters

- `payout_destination_id` string[]
- `store_id` string[]
- `status` string[]
- `device_model` string[]
- `device_serial_number` string[]
- `includes` string[]
- `terminal_id` string[]
- `search` string
- `starting_after` string
- `limit` integer

## Response `200`

List of terminals

- TerminalCollection
  - `starting_after` string
  - `terminals` object[], required
    - `id` string, uuid — An UUID that uniquely identifies the resource
    - `created_at` string, date-time — The date-time when the resource was created
    - `created_by` string — The ID of the user/client created the resource
    - `updated_at` string, date-time — The date-time when the resource was last updated
    - `deleted_by` string — The ID of the user/client created the resource
    - `deleted_at` string, date-time
    - `device_model` string
    - `store_id` string
    - `terminal_id` string, required
    - `device_serial_number` string, required
    - `status` 'DELETED' | 'PENDING' | 'ACTION_REQUIRED' | 'ACTIVE' | 'INACTIVE' | 'ERROR' — The status of the terminal
    - `status_reason` 'CHECK_UPDATE' — Context explaining why the terminal has its current status.
    - `store` object — Store details are included when the includes=store query parameter is used.
      - `id` string
      - `store_name` string

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