---
title: "Get terminal connectivity"
method: GET
path: "/v3/terminals/{serialNum}/connectivity"
tags: ["Terminal"]
---

# Get terminal connectivity

`GET /v3/terminals/{serialNum}/connectivity`

## Request

- Base URL: `https://testpayarcconnectapi.payarc.net`
- URL: `https://testpayarcconnectapi.payarc.net/v3/terminals/{serialNum}/connectivity`
- Auth: HTTP bearer

Returns whether the terminal currently has a live connection to the Payarc Connect platform (AWS IoT), sourced directly from IoT presence. This is a lightweight, low-latency check intended as a pre-transaction "is the terminal reachable?" gate. `online` is `true`/`false`, or `null` when no connection event has been observed for the terminal yet.

## Path parameters

- `serialNum` string, required

## Headers

- `Authorization` string, required

## Response `200`

Terminal connectivity.

- TerminalConnectivityResponse
  - `serialNumber` string: Terminal serial number.
  - `online` boolean, nullable: Whether the terminal currently has a live connection to the Payarc Connect platform (AWS IoT). `null` when no connection event has been observed for the terminal yet.
  - `lastConnectedAt` string, date-time, nullable: Timestamp of the terminal's most recent connect to Payarc Connect.
  - `lastDisconnectedAt` string, date-time, nullable: Timestamp of the terminal's most recent disconnect from Payarc Connect.

## Other responses

- `400`: Invalid Request
- `502`: Connectivity read error

---

[API](https://skmtc.dev/payarc/apis/payarc-connect-v3.md) - [All operations](https://skmtc.dev/payarc/apis/payarc-connect-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/payarc/apis/payarc-connect-v3/revisions/78418d530627?raw)