# Listar ejecuciones de nodos

> operationId: `listRunNodes`


## Solicitud

Enumera los resultados de ejecución de los nodos. Esta llamada consulta los registros de ejecución actuales; no es una transmisión de eventos. Los parámetros nodeId, workflowRevisionId, invocationPath, executionId y status son filtros opcionales de un solo valor y coincidencia exacta, y se combinan con AND. El filtro executionId coincide con items[].id. Los reintentos de la misma invocación actualizan el mismo id y attempts. Una invocación nueva dentro de un bucle o de un flujo secundario recibe un id nuevo, así que no combines los registros solo por nodeId. Los registros se agregan en un orden estable según su primera publicación. En cada pasada, vuelve a leer desde page=1 y sobrescribe tu caché local por id. No uses nodeId, total ni la última página como marca de agua incremental. Las páginas leídas mientras la ejecución está activa no forman una instantánea coherente. Cuando la ejecución alcance un estado terminal, lee todas las páginas sin filtro de estado para conciliar los datos. Para más detalles, consulta [Observación de ejecuciones y recuperación de solicitudes](/es/browser-rpa/api/observation). El campo data devuelve la salida real del nodo tal como es, sin ocultar nada (las credenciales, las cookies, los valores derivados de parámetros privados y las rutas locales aparecen en texto plano). Solo los manejadores ElementRef/FrameRef aparecen como `{kind,available:false}`, y no se pueden reutilizar entre ejecuciones. Cuando está presente, matchedIndex empieza en 1.

- **Requisitos previos**: Tienes un ID de ejecución que puedes leer.
- **Autenticación**: Igual que en el resto de la Local API; consulta [Autenticación](/es/api-reference/getting-started/authentication). Los recursos pertenecen al ámbito de datos de la cuenta/equipo actual.
- **Efectos secundarios**: Ninguno. Esta llamada no escribe datos de negocio.
- **Señal de finalización**: Un 200 devuelve el registro de ejecución de cada invocación de nodo.
- **Reintentos**: Las llamadas de solo lectura se pueden reintentar. Ante un 429 o un 503, espera el tiempo que indica Retry-After.


### Endpoint

```http
GET /api/rpa/browser/v1/runs/{runId}/nodes
```

Local API: `http://127.0.0.1:<port>/api/rpa/browser/v1/runs/{runId}/nodes`. Usa el puerto configurado en el cliente.

### Encabezados

| Parámetro | Tipo | Obligatorio | Descripción y restricciones |
|  --- | --- | --- | --- |
| `Authorization` | string | Cuando la autenticación de la Local API está habilitada | Consulta [Autenticación](/es/api-reference/getting-started/authentication). |


### Parámetros de ruta

| Parámetro | Tipo | Obligatorio | Descripción y restricciones |
|  --- | --- | --- | --- |
| `runId` | string | Sí | ID de la ejecución. Longitud mínima 1; longitud máxima 128. |


### Parámetros de consulta

| Parámetro | Tipo | Obligatorio | Descripción y restricciones |
|  --- | --- | --- | --- |
| `page` | integer | No | Número de página, a partir de 1. Mínimo 1; valor predeterminado 1. |
| `pageSize` | integer | No | Elementos por página. Valor predeterminado: 20; máximo: 100. Mínimo 1; máximo 100; valor predeterminado 20. |
| `nodeId` | string | No | ID de nodo estable en la plantilla. Longitud mínima 1; longitud máxima 128. |
| `workflowRevisionId` | string | No | ID de revisión del flujo de trabajo raíz o del flujo secundario al que pertenece el nodo. Longitud mínima 1; longitud máxima 128. |
| `invocationPath` | string | No | Cadena opaca copiada de items[].invocationPath. Se compara de forma exacta y no se analiza su estructura. Longitud mínima 1; longitud máxima 4096. |
| `executionId` | string | No | Coincide con items[].id, el ID de registro de una invocación de nodo. No es el nodeId. Longitud mínima 1; longitud máxima 128. |
| `status` | `running` / `success` / `failed` / `cancelled` | No | Un único estado de ejecución de nodo, no un estado de la ejecución. Se combina con los demás filtros mediante AND. |


### Cuerpo de la solicitud

Sin cuerpo de solicitud.

### Ejemplo de solicitud

Este es un ejemplo de la documentación; no se envió a un cliente real. Define `RPA_BASE_URL` como se describe en [Convenciones de la API](/es/browser-rpa/api/common). Las variables de recursos, la revisión del catálogo y los ETag provienen de respuestas reales.

```bash
curl -i -X GET "${RPA_BASE_URL}/runs/${RPA_RUN_ID}/nodes?page=1&pageSize=20"
```

## Respuesta

### 200

Un 200 devuelve el registro de ejecución de cada invocación de nodo.

Cuerpo: `application/json`. El `data` de nivel superior usa el modelo siguiente. Para `meta`, consulta [Metadata](/es/browser-rpa/api/data-types#metadata).

| Campo | Tipo | Obligatorio | Descripción y restricciones |
|  --- | --- | --- | --- |
| `items` | array<[NodeExecution](/es/browser-rpa/api/data-types#nodeexecution)> | Sí | Array de elementos de la página actual o del recurso actual. |
| `total` | integer | Sí | Número total de coincidencias. Mínimo 0. |
| `page` | integer | Sí | Número de página, a partir de 1. Mínimo 1. |
| `pageSize` | integer | Sí | Elementos por página. Valor predeterminado: 20; máximo: 100. Mínimo 1; máximo 100. |


### Ejemplo de respuesta

Todos los ID, marcas de tiempo, hashes y resultados de ejecución son datos de muestra. No indican que el ejemplo se haya ejecutado.

```json
{
  "data": {
    "items": [
      {
        "dataTruncated": false,
        "id": "node_execution_example",
        "nodeId": "url_result",
        "workflowRevisionId": "revision_example_1",
        "invocationPath": "root",
        "status": "success",
        "attempts": 1,
        "startedAt": 1793318402000,
        "endedAt": 1793318402100,
        "durationMs": 100,
        "data": {
          "value": "https://example.com/",
          "url": "https://example.com/",
          "origin": "https://example.com",
          "pathname": "/",
          "query": {}
        },
        "error": null,
        "artifacts": []
      }
    ],
    "total": 1,
    "page": 1,
    "pageSize": 20
  },
  "meta": {
    "requestId": "7d498f20-7bab-4e59-9b05-88daf51230e9",
    "catalogRevision": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}
```

### Respuestas de error

| HTTP | error.code | Qué hacer |
|  --- | --- | --- |
| 413 | RPA_LIMIT_EXCEEDED | details.limit=nodePageBytes. Reduce pageSize y vuelve a recorrer desde page=1. Si con pageSize=1 se sigue superando el límite, informa el límite. |


Para los errores comunes 400/401/403/404/429/5xx y los campos de error, consulta [Errores y recuperación](/es/browser-rpa/api/common#errores-y-recuperaci%C3%B3n). Ejemplo de respuesta de error (403):

```json
{
  "error": {
    "code": "RPA_PERMISSION_DENIED",
    "message": "The request Host or Origin is not allowed, or the current identity can't access the target environment",
    "retryable": false,
    "issues": [],
    "details": null
  },
  "meta": {
    "requestId": "7d498f20-7bab-4e59-9b05-88daf51230e9",
    "catalogRevision": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}
```

## Documentación relacionada

[Referencia de la Local API](/es/browser-rpa/local-api) · [Convenciones de la API](/es/browser-rpa/api/common) · [Modelos de datos](/es/browser-rpa/api/data-types) · [Estructura del flujo](/es/browser-rpa/api/workflow) · [Inicio rápido](/es/browser-rpa/quickstart)

### Semántica de los tiempos

`durationMs` es la duración de la acción que registra el ejecutor. `startedAt` y `endedAt` son las horas en que el servicio recibió los estados del nodo, por lo que incluyen la sobrecarga de mensajería y de persistencia. No esperes que durationMs sea igual a endedAt−startedAt. En los resultados de URL, pathname es la ruta de la página web (como `/fixture`). Las rutas de archivos locales también se devuelven tal como son.