GET https://api.fire.rest/api/v1/fire/external/stores/550e8400-e29b-41d4-a716-446655440000/terminals?type=KIOSK,POS
x-api-key: <your_api_key>
{
"terminals": [
{
"id": "8d0f6b1e-3c2a-4f57-9a61-0e2d4b7c9a10",
"storeId": "550e8400-e29b-41d4-a716-446655440000",
"name": "Caja 1",
"type": "POS",
"status": "ACTIVE",
"externalId": null,
"lastSeenAt": "2026-10-06T15:02:11Z",
"createdAt": "2026-09-01T10:00:00Z"
},
{
"id": "2b7e4a90-61d3-4c0e-8f2b-7a5c1d9e3f44",
"storeId": "550e8400-e29b-41d4-a716-446655440000",
"name": "Kiosco Entrada",
"type": "KIOSK",
"status": "ACTIVE",
"externalId": "K082-94",
"lastSeenAt": "2026-10-06T14:58:40Z",
"createdAt": "2026-09-03T12:30:00Z"
}
],
"total": 2
}
{
"success": false,
"error": "VALIDATION_ERROR",
"message": "Datos de entrada inválidos",
"details": [
{ "code": "custom", "path": ["status"], "message": "Invalid status: BROKEN. Allowed: ACTIVE, SUSPENDED, REVOKED" }
]
}
{
"success": false,
"error": "NOT_FOUND",
"message": "Store not found with ID 550e8400-e29b-41d4-a716-446655440000"
}
API
Listar terminales de una tienda
Lista las cajas POS, los kioscos y las pantallas de cocina registrados en una tienda, con su estado actual.
GET
/
api
/
v1
/
fire
/
external
/
stores
/
{storeId}
/
terminals
GET https://api.fire.rest/api/v1/fire/external/stores/550e8400-e29b-41d4-a716-446655440000/terminals?type=KIOSK,POS
x-api-key: <your_api_key>
{
"terminals": [
{
"id": "8d0f6b1e-3c2a-4f57-9a61-0e2d4b7c9a10",
"storeId": "550e8400-e29b-41d4-a716-446655440000",
"name": "Caja 1",
"type": "POS",
"status": "ACTIVE",
"externalId": null,
"lastSeenAt": "2026-10-06T15:02:11Z",
"createdAt": "2026-09-01T10:00:00Z"
},
{
"id": "2b7e4a90-61d3-4c0e-8f2b-7a5c1d9e3f44",
"storeId": "550e8400-e29b-41d4-a716-446655440000",
"name": "Kiosco Entrada",
"type": "KIOSK",
"status": "ACTIVE",
"externalId": "K082-94",
"lastSeenAt": "2026-10-06T14:58:40Z",
"createdAt": "2026-09-03T12:30:00Z"
}
],
"total": 2
}
{
"success": false,
"error": "VALIDATION_ERROR",
"message": "Datos de entrada inválidos",
"details": [
{ "code": "custom", "path": ["status"], "message": "Invalid status: BROKEN. Allowed: ACTIVE, SUSPENDED, REVOKED" }
]
}
{
"success": false,
"error": "NOT_FOUND",
"message": "Store not found with ID 550e8400-e29b-41d4-a716-446655440000"
}
Devuelve las terminales registradas en una tienda: cajas POS, kioscos de autoservicio y
pantallas de cocina KDS. Por defecto devuelve lo que la tienda tiene habilitado hoy, es decir,
las terminales activas y suspendidas. Las revocadas solo vienen si las pides con
status.
Si la tienda no existe o pertenece a otro tenant, la respuesta es 404 (nunca se revela si existe
en otro tenant).
Autenticación
string
requerido
Tu API key de Fire con el scope
store:read. La key debe estar asociada a un vendor. Las
keys sin vendorId se rechazan con 403.Path params
string
requerido
UUID de la tienda (
stores.id).Query params
string
Tipos de terminal separados por coma:
POS, KIOSK, KDS. Si lo omites, devuelve los tres.string
predeterminado:"ACTIVE,SUSPENDED"
Estados separados por coma:
ACTIVE, SUSPENDED, REVOKED.string
Lista de campos a devolver, separados por coma (projection). Ver
Projection de campos. Si lo omites, devuelve
todos los campos.
Petición
GET https://api.fire.rest/api/v1/fire/external/stores/550e8400-e29b-41d4-a716-446655440000/terminals?type=KIOSK,POS
x-api-key: <your_api_key>
Respuesta
object[]
Mostrar terminal
Mostrar terminal
string
UUID de la terminal.
string
UUID de la tienda.
string
Nombre visible de la terminal.
string
POS, KIOSK o KDS.string
ACTIVE operando, SUSPENDED pausada por un administrador, REVOKED dada de baja.string | null
Identificador externo del equipo. En kioscos, el device ID que muestra la pantalla QR.
null en POS y KDS.string | null
Última vez que la terminal se comunicó con Fire (ISO 8601).
null si nunca se conectó.string
Cuándo se registró la terminal (ISO 8601).
number
Cantidad de terminales devueltas.
{
"terminals": [
{
"id": "8d0f6b1e-3c2a-4f57-9a61-0e2d4b7c9a10",
"storeId": "550e8400-e29b-41d4-a716-446655440000",
"name": "Caja 1",
"type": "POS",
"status": "ACTIVE",
"externalId": null,
"lastSeenAt": "2026-10-06T15:02:11Z",
"createdAt": "2026-09-01T10:00:00Z"
},
{
"id": "2b7e4a90-61d3-4c0e-8f2b-7a5c1d9e3f44",
"storeId": "550e8400-e29b-41d4-a716-446655440000",
"name": "Kiosco Entrada",
"type": "KIOSK",
"status": "ACTIVE",
"externalId": "K082-94",
"lastSeenAt": "2026-10-06T14:58:40Z",
"createdAt": "2026-09-03T12:30:00Z"
}
],
"total": 2
}
{
"success": false,
"error": "VALIDATION_ERROR",
"message": "Datos de entrada inválidos",
"details": [
{ "code": "custom", "path": ["status"], "message": "Invalid status: BROKEN. Allowed: ACTIVE, SUSPENDED, REVOKED" }
]
}
{
"success": false,
"error": "NOT_FOUND",
"message": "Store not found with ID 550e8400-e29b-41d4-a716-446655440000"
}
Relacionado
Obtener tienda
Lee la configuración completa de la tienda.
Administración de terminales
Suspende, reactiva o revoca terminales desde el backoffice.