# Get run details

> operationId: `getRun`


## Request

Gets the details of a run. A result of null means that there is no result yet. For a terminal state, also check outputs, error, hasNodeErrors, and isolation. Report any terminal state other than success with its actual reason. When the state is failed and error.code is OUTCOME_UNKNOWN, do not run again automatically. The result.outputs field returns the actual values as is, without redaction (see [Data and execution boundaries](/browser-rpa/api/common#data-and-execution-boundaries)). The snapshot field contains only revision identifiers. It does not return the full original content, private parameters, debug, or rawResult.

- **Prerequisites**: The runId comes from the start response or from a run list within your authorized scope.
- **Authentication**: Same as the rest of the Local API; see [Authentication](/api-reference/getting-started/authentication). Resources belong to the current account/team data scope.
- **Side effects**: None. This call doesn't write business data.
- **Completion signal**: A 200 returns the current run, its result, and the frozen versions. It does not guarantee that the run has finished.
- **Retries**: Read-only calls can be retried. On 429 or 503, back off as indicated by 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}`. Use the port configured in the client.

### Headers

| Parameter | Type | Required | Description and constraints |
|  --- | --- | --- | --- |
| `Authorization` | string | When Local API authentication is enabled | See [Authentication](/api-reference/getting-started/authentication). |


### Path parameters

| Parameter | Type | Required | Description and constraints |
|  --- | --- | --- | --- |
| `runId` | string | Yes | ID of the run. Min length 1; max length 128. |


### Query parameters

None.

### Request body

No request body.

### Request example

This is a documentation example; it was not sent to a live client. Set `RPA_BASE_URL` as described in [API conventions](/browser-rpa/api/common). Resource variables, the catalog revision, and ETags come from actual responses.

```bash
curl -i -X GET "${RPA_BASE_URL}/runs/${RPA_RUN_ID}"
```

## Response

### 200

A 200 returns the current run, its result, and the frozen versions. It does not guarantee that the run has finished.

Body: `application/json`. The top-level `data` uses the model below. For `meta`, see [Metadata](/browser-rpa/api/data-types#metadata).

| Field | Type | Required | Description and constraints |
|  --- | --- | --- | --- |
| `run` | [RunSummary](/browser-rpa/api/data-types#runsummary) | Yes | Summary of the current run. |
| `result` | object or null | Yes | Run result; null if no result has been produced yet. outputs is the map of workflow outputs. If the run fails before execution starts (for example, a cloud request fails while the environment is being resolved), result.outputs is an empty object and result.error is the reason for the failure. |
| `snapshot` | object | Yes | Summary of the frozen template and dependency revisions, without the original content. |


**`result` fields**

| Field | Type | Required | Description and constraints |
|  --- | --- | --- | --- |
| `result.outputs` | [JsonObject](/browser-rpa/api/data-types#jsonobject) | Yes | Workflow outputs. The actual values are returned as is (not redacted). |
| `result.error` | [PublicError](/browser-rpa/api/data-types#publicerror) or null | Yes | Public error object, or null. |


**`snapshot` fields**

| Field | Type | Required | Description and constraints |
|  --- | --- | --- | --- |
| `snapshot.templateId` | string | Yes | Target template ID (the cloud ID of the template under Custom Templates in the desktop client, as a numeric string). Min length 1; max length 128. |
| `snapshot.version` | integer | Yes | Current editable template version. Read it from an actual response. Minimum 1. |
| `snapshot.revisionId` | string | Yes | Immutable revision ID. Min length 1; max length 128. |
| `snapshot.dependencyRevisions` | array<[DependencyPin](/browser-rpa/api/data-types#dependencypin)> | Yes | Exact dependency revisions used for freezing or validation. |


### Response example

All IDs, timestamps, hashes, and run results are sample data. They don't indicate that the sample was executed.

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

### Error responses

For common 400/401/403/404/429/5xx errors and failure fields, see [Errors and recovery](/browser-rpa/api/common#errors-and-recovery). Error response example (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"
  }
}
```

## Related

[Local API reference](/browser-rpa/local-api) · [API conventions](/browser-rpa/api/common) · [Data models](/browser-rpa/api/data-types) · [Workflow structure](/browser-rpa/api/workflow) · [Quickstart](/browser-rpa/quickstart)