---
title: "Retrieve all terminals"
method: GET
path: "/terminals"
tags: ["Terminals"]
---

# Retrieve all terminals

`GET /terminals`

## Request

- Base URL: `https://api.dojo.tech`
- URL: `https://api.dojo.tech/terminals`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/dojo/apis/dojo-api/docs/terminals/get.ts> (a function with typed inputs; its response is checked against the schema)

Allows you to retrieve details of all terminals.

## Query parameters

- `statuses` TerminalStatus[]

## Headers

- `version` string, date, required
- `software-house-id` string, required
- `reseller-id` string

## Response `200`

A list of terminals.

- Terminal[]
  - `id` string, required: The unique identifier for the terminal.
  - `properties` TerminalProperties, required: Properties related to the terminal.
    - `tid` string, required: An 8-digit identifier printed on receipts.
  - `status` 'Available' | 'Offline' | 'InUse', required: A machine-readable value describing the state of the terminal.
  - `updatedAt` string, date-time, required: The timestamp of the update date, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) UTC format.

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/dojo/apis/dojo-api.md) - [All operations](https://skmtc.dev/dojo/apis/dojo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dojo/apis/dojo-api/revisions/29fc8900ba37?raw)