# Obtener detalles de la ejecución

> operationId: `getRun`


## Solicitud

Obtiene los detalles de una ejecución. Un valor null en result significa que todavía no hay resultado. En un estado terminal, revisa también outputs, error, hasNodeErrors e isolation. Informa cualquier estado terminal distinto de success junto con su motivo real. Cuando el estado es failed y error.code es OUTCOME_UNKNOWN, no vuelvas a ejecutar automáticamente. El campo result.outputs devuelve los valores reales tal como son, sin ocultarlos (consulta [Límites de datos y de ejecución](/es/browser-rpa/api/common#l%C3%ADmites-de-datos-y-de-ejecuci%C3%B3n)). El campo snapshot solo contiene identificadores de revisión. No devuelve el contenido original completo, los parámetros privados, debug ni rawResult.

- **Requisitos previos**: El runId proviene de la respuesta de inicio o de una lista de ejecuciones dentro de tu ámbito autorizado.
- **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 la ejecución actual, su resultado y las versiones congeladas. No garantiza que la ejecución haya terminado.
- **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}
```

Local API: `http://127.0.0.1:<port>/api/rpa/browser/v1/runs/{runId}`. 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

Ninguno.

### 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}"
```

## Respuesta

### 200

Un 200 devuelve la ejecución actual, su resultado y las versiones congeladas. No garantiza que la ejecución haya terminado.

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 |
|  --- | --- | --- | --- |
| `run` | [RunSummary](/es/browser-rpa/api/data-types#runsummary) | Sí | Resumen de la ejecución actual. |
| `result` | object o null | Sí | Resultado de la ejecución; es null si aún no se ha producido ningún resultado. outputs es el mapa de salidas del flujo de trabajo. Si la ejecución falla antes de que empiece a ejecutarse (por ejemplo, si falla una solicitud a la nube mientras se resuelve el entorno), result.outputs es un objeto vacío y result.error es el motivo del fallo. |
| `snapshot` | object | Sí | Resumen de las revisiones congeladas de la plantilla y de las dependencias, sin el contenido original. |


**Campos de `result`**

| Campo | Tipo | Obligatorio | Descripción y restricciones |
|  --- | --- | --- | --- |
| `result.outputs` | [JsonObject](/es/browser-rpa/api/data-types#jsonobject) | Sí | Salidas del flujo de trabajo. Los valores reales se devuelven tal como son (sin ocultar). |
| `result.error` | [PublicError](/es/browser-rpa/api/data-types#publicerror) o null | Sí | Objeto de error público, o null. |


**Campos de `snapshot`**

| Campo | Tipo | Obligatorio | Descripción y restricciones |
|  --- | --- | --- | --- |
| `snapshot.templateId` | string | Sí | ID de la plantilla de destino (el ID en la nube de la plantilla en Plantillas personalizadas del cliente de escritorio, como cadena numérica). Longitud mínima 1; longitud máxima 128. |
| `snapshot.version` | integer | Sí | Versión editable actual de la plantilla. Léela de una respuesta real. Mínimo 1. |
| `snapshot.revisionId` | string | Sí | ID de revisión inmutable. Longitud mínima 1; longitud máxima 128. |
| `snapshot.dependencyRevisions` | array<[DependencyPin](/es/browser-rpa/api/data-types#dependencypin)> | Sí | Revisiones exactas de las dependencias que se usan para la congelación o la validación. |


### 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": {
    "run": {
      "id": "run_example",
      "status": "success",
      "template": {
        "id": "template_example",
        "title": "Read the page URL",
        "version": 1,
        "revisionId": "revision_example_1"
      },
      "environment": {
        "id": "environment_example",
        "name": "Example browser profile"
      },
      "createdAt": 1793318400000,
      "startedAt": 1793318401000,
      "endedAt": 1793318403000,
      "startAfter": null,
      "hasNodeErrors": false,
      "isolation": null
    },
    "result": {
      "outputs": {
        "result": "https://example.com/"
      },
      "error": null
    },
    "snapshot": {
      "templateId": "template_example",
      "version": 1,
      "revisionId": "revision_example_1",
      "dependencyRevisions": []
    }
  },
  "meta": {
    "requestId": "7d498f20-7bab-4e59-9b05-88daf51230e9",
    "catalogRevision": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}
```

### Respuestas de error

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)