---
title: "Get a list of terminals"
method: GET
path: "/terminals"
tags: ["Terminals - terminal level"]
---

# Get a list of terminals

`GET /terminals`

Returns the payment terminals that the API credential has access to and that match the query parameters. 
To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions):
* Management API — Terminal actions read

In the live environment, requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment).

## Query parameters

- `searchQuery` string
- `otpQuery` string
- `countries` string
- `merchantIds` string
- `storeIds` string
- `brandModels` string
- `pageNumber` integer
- `pageSize` integer

## Response `200`

OK - the request has succeeded.

- ListTerminalsResponse
  - `_links` PaginationLinks
    - `first` LinksElement, required
      - `href` string
    - `last` LinksElement, required
      - `href` string
    - `next` LinksElement
      - `href` string
    - `prev` LinksElement
      - `href` string
    - `self` LinksElement, required
      - `href` string
  - `data` Terminal[] — The list of terminals and their details.
    - `assigned` boolean — The [assignment status](https://docs.adyen.com/point-of-sale/automating-terminal-management/assign-terminals-api) of the terminal. If true, the terminal is assigned. If false, the terminal is in inventory and can't be boarded.
    - `bluetoothIp` string — The Bluetooth IP address of the terminal.
    - `bluetoothMac` string — The Bluetooth MAC address of the terminal.
    - `city` string — The city where the terminal is located.
    - `companyAccount` string — The company account that the terminal is associated with. If this is the only account level shown in the response, the terminal is assigned to the inventory of the company account.
    - `countryCode` string — The country code of the country where the terminal is located.
    - `deviceModel` string — The model name of the terminal.
    - `ethernetIp` string — The ethernet IP address of the terminal.
    - `ethernetMac` string — The ethernet MAC address of the terminal.
    - `firmwareVersion` string — The software release currently in use on the terminal.
    - `iccid` string — The integrated circuit card identifier (ICCID) of the SIM card in the terminal.
    - `id` string — The unique identifier of the terminal.
    - `lastActivityDateTime` string, date-time — Date and time of the last activity on the terminal. Not included when the last activity was more than 14 days ago.
    - `lastTransactionDateTime` string, date-time — Date and time of the last transaction on the terminal.
    - `linkNegotiation` string — The Ethernet link negotiation that the terminal uses: - `auto`: Auto-negotiation - `100full`: 100 Mbps full duplex
    - `serialNumber` string — The serial number of the terminal.
    - `simStatus` string — On a terminal that supports 3G or 4G connectivity, indicates the status of the SIM card in the terminal: ACTIVE or INVENTORY.
    - `status` string — Indicates when the terminal was last online, whether the terminal is being reassigned, or whether the terminal is turned off. If the terminal was last online more that a week ago, it is also shown as turned off.
    - `storeStatus` string — The status of the store that the terminal is assigned to.
    - `wifiIp` string — The terminal's IP address in your Wi-Fi network.
    - `wifiMac` string — The terminal's MAC address in your Wi-Fi network.
    - `wifiSsid` string — The SSID of the Wi-Fi network that your terminal is connected to.
  - `itemsTotal` integer, required — Total number of items.
  - `pagesTotal` integer, required — Total number of pages.

## 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/management-api.md) · [All operations](https://skmtc.net/adyen/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/management-api/revisions/1089ade06e17/schema)