---
title: "Get KeepAlive data for a given terminal ID"
method: POST
path: "/public/keepalive"
tags: ["Merchant Portal services API"]
---

# Get KeepAlive data for a given terminal ID

`POST /public/keepalive`

## Request

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

Returns Keep Alive data for a given Terminal Id.<br>
Required role for operation: TE_KEEP_ALIVE_LIST.<br>
Create MPauditlog table record with event type : KeepAlive (28)<br>
Supported authentication:<br>
* <b>Bearer</b> &lt;token&gt;, which is a Bearer token authentication. The bearer token is a cryptic string, usually generated by the server in response to a login request.
* <b>Basic</b> &lt;credentials&gt;, where credentials is the Base64 encoding of username and password joined by a single colon :, CAS login service will be called for the given username and password for validating credentials.

## Request body

- KeepAliveRequest
  - `terminalId` integer
  - `hwserialno` string
  - `kaDateTimeFrom` string
  - `kaDateTimeTo` string
  - `terminalDateTimeFrom` string
  - `terminalDateTimeTo` string
  - `pagination` PaginationRequest
    - `page` integer
    - `size` integer

## Response `200`

Successful operation

- KeepAliveResponse
  - `responseCode` integer
  - `responseMessage` string
  - `keepAliveData` KeepAlive[]
    - `terminalId` integer
    - `hwSerialNo` string
    - `kaDateTime` string, date-time
    - `terminalDateTime` string, date-time
    - `swVersion` string
    - `swVersionExpec` string
    - `pinPadSn` string
    - `pinPadSnExpec` string
    - `pinPadFw` string
    - `pinPadFwExpec` string
    - `responseDateTime` string, date-time
    - `responseConfigParam` string
    - `kaResponseCode` number
    - `kaConfigParams` string
    - `termConfigParams` string
  - `pagination` PaginationResponse
    - `page` integer
    - `size` integer
    - `totalElements` integer
    - `totalPages` integer

## Other responses

- `401`: Unauthorized - Authentication failed, e.g. MandatorId does not march
- `403`: Forbidden - Missing role: TE_KEEP_ALIVE_LIST
- `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/keepalive/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)