---
title: "Lista las ejecuciones paginadas de un flujo"
method: GET
path: "/workspaces/{workspaceId}/flows/{id}/runs"
tags: ["Flows"]
---

# Lista las ejecuciones paginadas de un flujo

`GET /workspaces/{workspaceId}/flows/{id}/runs`

## Request

- Base URL: `https://api.met.meteor.com.co/api/v1`
- URL: `https://api.met.meteor.com.co/api/v1/workspaces/{workspaceId}/flows/{id}/runs`
- Auth: one of:
  - `bearer` (a scheme the document does not define)
  - HTTP bearer

De la más reciente a la más vieja. `limit` es 50 por defecto y **topa en 200** — pedir más no falla, devuelve 200. Se pagina con `offset`.

## Path parameters

- `workspaceId` number, required
- `id` string, required

## Query parameters

- `limit` string, required
- `offset` string, required

## Response `200`

- object: Sobre en el que viaja toda respuesta correcta de la API. El recurso está en `data`. Los SDKs oficiales lo desenvuelven por ti; un cliente hecho a mano tiene que leer `.data`.
  - `success` true, required: Siempre `true` en una respuesta 2xx.
  - `data` FlowRunResponseDto[], required
    - `created_by` number, nullable, required
    - `definition_id` number, nullable: Referencia a la definición ejecutada, en el catálogo `flow_definitions`.
    - `definition_used` FlowDefinitionDto, required
      - `edges` FlowEdgeDto[], required
        - `id` string, required
        - `source` string, required: `id` del nodo origen.
        - `sourceHandle` string, nullable: Handle de salida del origen — relevante en condición (sí/no) y en bifurcaciones.
        - `target` string, required: `id` del nodo destino.
        - `targetHandle` string, nullable
      - `nodes` FlowNodeDto[], required
        - `data` object, required: Config del nodo. Su forma depende del `type`: los campos válidos de cada uno están declarados en `GET /node-registry` (`fields[]`).
        - `id` string, required: UUID generado por el cliente al arrastrar el nodo a la paleta.
        - `position` FlowNodePositionDto, required
          - `x` number, required
          - `y` number, required
        - `type` string, required: Tipo declarado en el node-registry (`GET /node-registry`).
    - `duration_ms` number, nullable, required
    - `error` string, nullable, required: Mensaje del fallo cuando `status` es `failed`; `null` en cualquier otro caso.
    - `finished_at` string, nullable, required: Cuándo llegó a un estado terminal. `null` si sigue corriendo o esperando.
    - `flow_id` string, required
    - `id` string, required
    - `result_text` string, nullable, required: Texto que el nodo `function.result` devuelve al Met. `null` si el flujo no tiene uno.
    - `source` 'manual' | 'automation' | 'parent_flow' | 'broadcast' | 'function' | 'channel', required: Qué originó la corrida.
    - `source_id` string, nullable, required: ID de lo que la originó (la automatización, el flujo padre, el canal…).
    - `started_at` string, required
    - `status` 'running' | 'success' | 'failed' | 'cancelled' | 'waiting', required: `waiting` = suspendida por un nodo interactivo que espera respuesta del contacto.
    - `trigger_payload` TriggerPayloadDto, required
      - `kind` 'contact' | 'item' | 'product' | 'post' | 'event' | 'empty', required: Qué tipo de entidad disparó el flujo. `empty` = disparo sin carga.
      - `payload` object, required: Los datos de esa entidad. Forma libre: depende del `kind`.
    - `workspace_id` number, required

## Other responses

- `400`: La request no es válida: un campo no pasa validación, falta un parámetro requerido o el recurso no admite la transición solicitada.
- `401`: API key ausente, inválida, revocada o expirada — o el workspace está bloqueado.
- `403`: La key está autenticada pero no puede ejecutar esta operación: scope faltante, capacidad deshabilitada, modo test restringido o recurso fuera de su cartera.
- `404`: El recurso no existe o no está disponible dentro del alcance de la key. No revela la existencia de recursos de otros tenants.
- `429`: Se superó el límite por minuto de la key o la cuota del plan. Respeta `Retry-After`; el SDK ya reintenta solo.
- `500`: Error del servidor o del Met que ejecutaba. El SDK reintenta los 5xx con backoff.

---

[API](https://skmtc.dev/meteor/apis/met-public-api.md) · [All operations](https://skmtc.dev/meteor/apis/met-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meteor/apis/met-public-api/revisions/5d9ca294295c?raw)