---
title: "List registered terminals"
method: POST
path: "/public/listTerminals"
tags: ["Merchant Portal services API"]
---

# List registered terminals

`POST /public/listTerminals`

## Request

- Base URL: `https://test.tecs.at/merchantservices`
- URL: `https://test.tecs.at/merchantservices/public/listTerminals`
- Auth: HTTP bearer

Returns list of registered terminals by given parameter corporateUuid.<br>

Required role for operation: TE_MERCHANT_TERMINAL_MANAGEMENT.<br>
Create MPauditlog record with event type : ListTerminals (13).<br>

Supports authentication with the following types of tokens:<br>
- Bearer <token>, which is a Bearer token authentication. The bearer token is a cryptic string, usually generated by the server in response to a login request.

## Request body

- ListTerminalsRequest
  - `corporateUuid` string[]
  - `filter` Filter
    - `corporateUuid` string[]
    - `hwserialno` string[]
    - `fulltextSearch` string
    - `terminalType` string
  - `pagination` PaginationRequest
    - `page` integer
    - `size` integer

## Response `200`

Successful operation

- ListTerminalsResponse
  - `responseCode` integer
  - `responseMessage` string
  - `terminals` Terminal[]
    - `packageOrderUuid` string
    - `termn` string
    - `no` string
    - `currency` string
    - `hwSerialNo` string
    - `status` string
    - `termModel` string
    - `termLocation` string
    - `mpExpectedSerialNo` string
    - `keepAliveStatus` string
    - `kaDateTimeCreate` string, date-time
    - `acquirings` TerminalAcquiringDto[]
      - `productOrderUuid` string
      - `name` string

## Other responses

- `400`: Bad request
- `401`: Unauthenticated - Authentication failed
- `403`: Unauthorized - Missing role TE_MERCHANT_TERMINAL_MANAGEMENT
- `500`: Internal server error

## Changes

- **2026-11-03** `6e0e5a5a2b2f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bluefin-com/apis/merchant-services/changes/public/listTerminals/post.md)

---

[API](https://skmtc.dev/bluefin-com/apis/merchant-services.md) - [All operations](https://skmtc.dev/bluefin-com/apis/merchant-services/llms.txt) - [OpenAPI document](https://skmtc.dev/bluefin-com/apis/merchant-services/revisions/6e0e5a5a2b2f?raw)