---
title: "List terminals"
method: GET
path: "/terminal"
tags: ["Terminals"]
---

# List terminals

`GET /terminal`

List all terminals (POS devices) from your account.

**Required scope:** <code style="background:#e8f0fe;color:#1a73e8;padding:2px 8px;border-radius:12px;font-size:0.85em">terminal:read</code>

## Query parameters

- `cursor` string
- `limit` number
- `name` string
- `status` 'ACTIVE' | 'INACTIVE'
- `model` string

## Response `200`

OK

- object
  - `metadata` MetadataCursor, required — An object containing additional information about the response. It includes details that help manage and navigate the retrieved data.
    - `next_cursor` string, required — Provides the cursor for the next set of records. This value should be used as the cursor parameter in subsequent requests to continue paginating through the data. If the cursor is an empty string or null, it indicates that there are no more results. To retrieve all available results, continue making subsequent requests until next_cursor is empty or null.
    - `count` number, required — The total number of records in the current response. This field indicates the number of items returned in the current set of results.
  - `data` Terminal[], required
    - `id` string, uuid — The unique identifier of the terminal.
    - `serial_number` string — The serial number of the terminal device. Unique per acquirer.
    - `name` string — The name of the terminal. Must be unique.
    - `status` 'ACTIVE' | 'INACTIVE' | 'DELETED' — The current status of the terminal. Determined by the device state.
    - `acquirer` 'VERIFONE' — The acquirer associated with the terminal.
    - `model` string — The model of the terminal device. Inferred from the serial number.
    - `last_transaction_at` string, date-time, nullable — The date and time of the last transaction processed by the terminal. Null if no transactions have been processed.
    - `created_at` string, date-time — The date and time when the terminal was created.

## Other responses

- `403` — Forbidden
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/easypay/apis/easypay-payments-api.md) · [All operations](https://skmtc.net/easypay/apis/easypay-payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/easypay/easypay-payments-api/versions/cdf25a9ad7b2/schema)