---
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`

## Request

- Base URL: `https://tb.paymentfusion.com`
- URL: `https://tb.paymentfusion.com/terminals/status`
- Auth: none declared. Required headers: `Authorization`, `Accept`

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.dev/bankofamerica/apis/transaction-broker-api.md) - [All operations](https://skmtc.dev/bankofamerica/apis/transaction-broker-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bankofamerica/apis/transaction-broker-api/revisions/6097bc689e41?raw)