Get an Execution Status

Use this endpoint to retrieve the current status of a specific workflow execution.

GET /v1/executions/{id}

Get an Execution Status

cURL

curl --request GET \
  --url https://flowker.sandbox.lerian.net/v1/executions/{id} \
  --header 'Authorization: Bearer <token>'

200

{
  "completedAt": "2026-03-17T14:35:12Z",
  "currentStepNumber": 1,
  "errorMessage": "<string>",
  "executionId": "f7e6d5c4-b3a2-1098-7654-321fedcba098",
  "startedAt": "2026-03-17T14:35:00Z",
  "status": "completed",
  "totalSteps": 1,
  "workflowId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "startedBy": {
    "id": "018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8",
    "kind": "application"
  },
  "triggerNodeId": "trigger-1",
  "wait": {
    "deadline": "2026-01-15T10:32:00Z",
    "nodeId": "wait-1"
  }
}

Autorizaciones

Authorization · string · header · requerido

JWT bearer token issued by the identity provider. Send it in the Authorization header as Bearer <token>.

Parámetros de ruta

id · string<uuid> · requerido

Unique identifier of the execution.

Respuesta

200

application/json

Indicates that the request was successful and the response contains the requested data.

completedAt · string<date-time>

Timestamp when the execution finished. Null if still running.

Ejemplo:

"2026-03-17T14:35:12Z"

currentStepNumber · integer

Number of the step currently being executed (1-indexed).

Ejemplo:

1

errorMessage · string

Error message if the execution failed. Null on success.

executionId · string<uuid>

Unique identifier of the execution.

Ejemplo:

"f7e6d5c4-b3a2-1098-7654-321fedcba098"

startedAt · string<date-time>

Timestamp when the execution started.

Ejemplo:

"2026-03-17T14:35:00Z"

status · enum<string>

Current status: pending (queued), running (in progress), waiting (parked at a wait node), completed (success), or failed (error).

Opciones disponibles: pending, running, waiting, completed, failed

Ejemplo:

"completed"

totalSteps · integer

Total number of steps in the workflow.

Ejemplo:

1

workflowId · string<uuid>

ID of the workflow being executed.

Ejemplo:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

startedBy · object

Verified application or person that started the execution; for a schedule occurrence an operator forced to run, that operator. Omitted when no caller was verified: the trigger tells the origin (schedule, Streaming Hub).

Show child attributes

triggerNodeId · string

Trigger node the execution started at.

Ejemplo:

"trigger-1"

wait · object

Present only while status is waiting: the wait node the execution is parked at and when it resumes.

Show child attributes