Get a run

GET

workflows

{id}

runs

{runId}

curl "https://api.nedzo.ai/v1/workflows/123e4567-e89b-12d3-a456-426614174000/runs/623e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "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
    }
  ]
}

This endpoint is for the VIP plan only. Other plans get a 403. See 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.

Path Parameters

string

required

The workflow’s id.

string

required

The run’s id.

curl "https://api.nedzo.ai/v1/workflows/123e4567-e89b-12d3-a456-426614174000/runs/623e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "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.

curl "https://api.nedzo.ai/v1/workflows/123e4567-e89b-12d3-a456-426614174000/runs/623e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "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
    }
  ]
}

API Reference

Workspaces

Agents

Phone Numbers

Contacts

Knowledge

Templates

Campaigns

Workflows

Conversations

Path Parameters

Errors