---
title: "Consultar un comando de impresión"
method: GET
path: "/terminal_print_commands/{random_id}"
tags: ["terminalPrintCommands"]
---

# Consultar un comando de impresión

`GET /terminal_print_commands/{random_id}`

## Request

- Base URL: `https://app.recurrente.com/api`
- URL: `https://app.recurrente.com/api/terminal_print_commands/{random_id}`
- Auth: API key in header `X-SECRET-KEY`
- TypeScript: <https://skmtc.dev/recurrente/apis/referencia-api/docs/terminal_print_commands/:random_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retorna el comando tal como se creó. La terminal no reporta si el papel salió, así que esta consulta confirma qué se pidió imprimir, no el resultado de la impresora.

## Path parameters

- `random_id` string, required

## Response `200`

El comando de impresión

- TerminalPrintCommand
  - `id` string: ID público del comando de impresión
  - `external_id` string, nullable: ID de tu sistema enviado al crear el comando, o `null` si no se envió uno
  - `terminal_id` string: ID de la terminal POS que imprime
  - `checkout_id` string: ID del checkout de la venta impresa
  - `copy` 'merchant' | 'customer': Cuál copia se mandó a imprimir
  - `duplicate` boolean: Indica si el papel sale marcado como DUPLICADO
  - `created_at` string, date-time: Momento en que se creó el comando

## Other responses

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

## Changes

- **2026-09-19** `33bad9197d59`: 2 breaking
  - added `#/components/schemas/ErrorErrors0` to the `errors` response property `oneOf` list for the response status `404`
  - the `errors/oneOf[subschema #1 -> subschema #2]/` response's property type changed from `object` to `array` for status `404`
- **2026-09-17** `3d76463f9fd8`: 1 warning, 1 info
  - deleted the `header` request parameter `X-SECRET-KEY`
  - the endpoint scheme security `secretKey` was added to the API
- **2026-09-16** `3389210172a9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/recurrente/apis/referencia-api/changes/terminal_print_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.dev/recurrente/apis/referencia-api/revisions/1a3fc480dd94?raw)
