# Retrieves a merchant's terminal POS status by ID

<span class="api-endpoint">GET {{<a href="#urlbases">baseURL</a>}}/pos-api/v1/terminals/{{terminalId}}/status</span>
Retrieves the current status and details of a terminal device.
This endpoint provides the latest available information about a terminal,
updated in near real-time.
Depending on the terminal's internet connectivity and operational status,
the response may include limited terminal data.

Endpoint: GET /pos-api/v1/terminals/{id}/status
Version: V1
Security: Bearer

## Path parameters:

  - `terminalId` (string, required)
    TerminalId

## Response 200 fields (application/json):

  - `terminalId` (string)
    Terminal Id

  - `timestamp` (string)
    Indicates the date-time (in an ISO 8601 date-time UTC format) of the terminal's status log.

Examples: 2026-02-19T20:24:52.934Z
    Example: 2026-02-19T20:24:52.934Z

  - `connectionStatusId` (integer)
    Possible values:
1 - Online: 2 - Offline:

  - `connectionStatus` (string)

  - `connectionTypeId` (integer)
    Possible values:
1 - WiFi: 2 - Mobile: 3 - Ethernet:

  - `connectionType` (string)

  - `wifiConnectionStrength` (integer)
    Wifi Connection Strength 0-100

  - `mobileConnectionStrength` (integer)
    Mobile Connection Strength 0-100

  - `lastSeenTimestamp` (string)
    Indicates the date-time (in an ISO 8601 date-time UTC format) of the terminal's online status.

Examples: 2026-02-19T20:24:52.934Z
    Example: 2026-02-19T20:24:52.934Z

  - `debitPinKeyId` (integer)
    Possible values:
1 - Injected: 2 - Missing:

  - `debitPinKey` (string)

  - `availabilityStatusId` (integer)
    Indicaates the terminal availability status.
Possible values:
| Id | Description |
|  --- | --- |
| 1 | Ready |
| 2 | Busy |

Example: 1
    Example: 1

  - `availabilityStatus` (string)

  - `ariseTerminalVersion` (string)
    ARISE Terminal version

  - `batteryLevel` (integer)
    Battery Level 0-100

  - `printerStatusId` (integer)
    Possible values:
1 - Normal: 2 - NotNormal: 3 - NotSupported:

  - `printerStatus` (string)

  - `deviceSoftwareDetails` (object)

  - `deviceSoftwareDetails.operatingSystem` (string)
    Operating System

  - `deviceSoftwareDetails.androidBaseServiceVersion` (string)
    Android Base Service Version

  - `deviceSoftwareDetails.sunmiTrustedManagementVersion` (string)
    Sunmi Trusted Management Version

  - `deviceSoftwareDetails.sunmiCloudConnectionVersion` (string)
    Sunmi Cloud Connection Version

  - `deviceSoftwareDetails.sunmiPayHardwareServiceVersion` (string)
    Sunmi Pay Hardware Service Version

  - `deviceSoftwareDetails.posStewardAppVersion` (string)
    POS Steward app version

  - `deviceSoftwareDetails.remoteAssistanceAppVersion` (string)
    Remote Assistance app version

  - `deviceSoftwareDetails.sunmiFutureXAppVersion` (string)
    SUNMI FutureX app version

  - `deviceSoftwareDetails.sunmiRomVersion` (string)
    Sunmi ROM Version

  - `terminalPosStatusId` (integer)
    Indicates the terminal availability status.
Possible values:
| Id | Description |
|  --- | --- |
| 1 | Ready |
| 2 | Busy |

Example: 1
    Example: 1

  - `terminalPosStatus` (string)
    Terminal Status name.
Active = 1 - terminal is online and ready to accept the POS transaction
Busy = 2 - terminal is online, but cannot accept the POS transaction
Offline = 3 - terminal is not subscribed for push notifications, or didn't respond before timeout issued