---
title: "Consultar un comando de terminal"
method: GET
path: "/terminal_session_commands/{random_id}"
tags: ["terminalSessionCommands"]
---

# Consultar un comando de terminal

`GET /terminal_session_commands/{random_id}`

Retorna el estado actual del comando. `final: true` indica que ya no puede cambiar: el resultado será `canceled`, `superseded`, `consumed` o `failed`.

Usa esta consulta para reconciliar timeouts y evitar crear un segundo cobro mientras el primer comando siga en `pending`, `dispatched` o `cancel_requested`.

## Path parameters

- `random_id` string, required

## Headers

- `X-SECRET-KEY` string, required

## Response `200`

Estado actual del comando

- TerminalSessionCommand
  - `id` string — ID público aleatorio del comando
  - `external_id` string — ID único de tu sistema dentro de la cuenta autenticada
  - `status` 'pending' | 'dispatched' | 'cancel_requested' | 'canceled' | 'superseded' | 'consumed' | 'failed' — Estado del comando
  - `final` boolean — `true` cuando el comando alcanzó un resultado definitivo y ya no puede cambiar
  - `terminal_id` string — ID de la terminal POS
  - `amount_in_cents` integer — Monto en centavos. Para un cobro con `items`, la suma de los items.
  - `currency` 'GTQ' | 'USD' — Moneda del cobro
  - `installments` integer, nullable — Meses sin intereses solicitados, o `null` si el cobro va sin cuotas
  - `description` string, nullable — Concepto del cobro enviado al crear el comando, o `null` si no se envió uno
  - `show_post_payment_screens` boolean — Indica si el comando solicita mostrar las pantallas post-pago de NIT, correo y teléfono
  - `print_receipt` boolean — Indica si el comando solicita imprimir automáticamente el comprobante de pago
  - `terminal_availability` 'available' | 'unavailable' — Disponibilidad observada de la terminal para recibir comandos
  - `checkout_id` string — ID del checkout generado
  - `checkout_url` string, uri — URL del checkout (la terminal usa esta URL internamente)
  - `checkout_status` 'unpaid' | 'paid' | 'failed' | 'payment_in_progress' | 'needs_verification' | 'no_payment_required' | 'verification_failed' | 'needs_payer_authentication' — Estado actual del checkout asociado
  - `cancellation_requested_at` string, date-time, nullable — Momento en que se solicitó detener un comando ya despachado
  - `canceled_at` string, date-time, nullable — Momento en que la cancelación se volvió definitiva

## Other responses

- `404` — No existe un comando con ese random_id en la cuenta autenticada

## Changes

- **2026-09-02** `da12dce50f30` — 2 info
  - added the optional property `description` to the response with the `200` status
  - added the optional property `print_receipt` to the response with the `200` status

[Change history](https://skmtc.dev/recurrente/apis/referencia-api/changes/terminal_session_commands/:random_id/get.md)

---

[API](https://skmtc.dev/recurrente/apis/referencia-api.md) · [All operations](https://skmtc.dev/recurrente/apis/referencia-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recurrente/referencia-api/revisions/da12dce50f30/schema)