> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nedzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a run

> Get one run with the result of each step it reached.

> [!NOTE]
>
> This endpoint is for the VIP plan only. Other plans get a `403`. See [Plan access](https://docs.nedzo.ai/api-reference/introduction.md#plan-access).

One run with the result of each step it reached. The run's `status` and `triggerType` are the same as in [List runs of a workflow](https://docs.nedzo.ai/api-reference/workflows/runs.md).

## Path Parameters

**id** `string` *required*

The workflow's id.

**runId** `string` *required*

The run's id.

```bash cURL theme={null}
curl "https://api.nedzo.ai/v1/workflows/123e4567-e89b-12d3-a456-426614174000/runs/623e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```json Response theme={null}
{
  "id": "623e4567-e89b-12d3-a456-426614174000",
  "workflowId": "123e4567-e89b-12d3-a456-426614174000",
  "workspaceId": "223e4567-e89b-12d3-a456-426614174000",
  "workflowName": "Welcome text",
  "status": "completed",
  "triggerType": "contact_created",
  "isTest": false,
  "errorMessage": null,
  "contactId": "523e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2026-10-11T09:00:00Z",
  "startedAt": "2026-10-11T09:00:00Z",
  "completedAt": "2026-10-11T09:00:02Z",
  "steps": [
    {
      "stepId": "text",
      "name": "text",
      "type": "sendSms",
      "status": "completed",
      "startedAt": "2026-10-11T09:00:01Z",
      "completedAt": "2026-10-11T09:00:02Z",
      "errorMessage": null
    }
  ]
}
```

A step's `name` is the name it has in the dashboard editor. A step with no name there shows its id.

`errorMessage` is a plain line. Some errors have their own line, like "The contact has DND on." or "The contact has no phone number." Every other error reads "This step could not finish." We never send the raw error text. The step that failed has the same line as the run.

## Errors

| Status | When |
| - | - |
| `400` | The workflow id or run id is not a valid UUID. |
| `402` | The account has no plan, or its subscription is not active. |
| `403` | Your plan is not VIP. |
| `404` | No workflow or run has this id, or it is not in this key's scope. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.