---
title: "Get a terminal's status, by serial number or client_id"
method: GET
path: "/terminals/status"
tags: ["Terminals"]
---

# Get a terminal's status, by serial number or client_id

`GET /terminals/status`

Gets the status of a single terminal by querying by serial_number or client_id

## Query parameters

- `serial_number` string, required
- `client_id` string, required
- `show_terminal_details` boolean

## Headers

- `Authorization` string, api_id:api_token, required
- `Accept` string, required

## Response `200`

Possible responses

- union
  - TerminalStatusResponse — Success
    - `online` boolean — Current state of terminal
    - `v` string — The API version that was used to handle the request.
  - TerminalStatusDetailedResponse — Success
    - `online` boolean — Current state of terminal
    - `busy` boolean — Reveals if terminal is busy handling a job or not
    - `tb_id` integer — The id of the job that is currently being handled
    - `card_inserted` boolean — Reveals if the terminal has a card inserted or not
    - `v` string — The API version that was used to handle the request.

## Other responses

- `4XX` — Possible errors - 1, 96, 189, 234, 235, 257

---

[API](https://skmtc.net/bankofamerica/apis/transaction-broker-api.md) · [All operations](https://skmtc.net/bankofamerica/apis/transaction-broker-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bankofamerica/transaction-broker-api/revisions/6097bc689e41/schema)