Skip to main content
Retrieve a paginated list of execution history for a specific workflow.

​
Overview

The Workflow Executions endpoint returns the run history for a given workflow, including status, duration, and error information for each execution. Use this to monitor workflow health, debug failures, and track execution patterns over time.

​
Authentication

Requires a valid API key. No special permission scope is needed beyond a valid key.

​
Key Features

  • Full Run History: Every execution attempt with status and timing
  • Error Visibility: See error messages for failed runs
  • Paginated: Handle workflows with many executions
  • No Credit Cost: This endpoint is free to use
curl -X GET "https://api.trigify.io/v1/workflows/wf_abc123/executions?page=1&page_size=20" \
  -H "x-api-key: YOUR_API_KEY"

​
Path Parameters

ParameterTypeDescription
idstringThe unique workflow ID

​
Query Parameters

ParameterTypeDefaultDescription
pageinteger1Page number (minimum 1)
page_sizeinteger20Results per page (1-100)

​
Example Response

{
  "success": true,
  "data": {
    "executions": [
      {
        "run_id": "run_x7k9m2",
        "status": "completed",
        "started_at": "2026-03-27T10:15:00.000Z",
        "completed_at": "2026-03-27T10:15:04.320Z",
        "duration": 4320,
        "error": null
      },
      {
        "run_id": "run_p3n8q1",
        "status": "failed",
        "started_at": "2026-03-27T09:00:00.000Z",
        "completed_at": "2026-03-27T09:00:02.150Z",
        "duration": 2150,
        "error": "Step 'Enrich profile' failed: profile not found"
      },
      {
        "run_id": "run_a1b2c3",
        "status": "running",
        "started_at": "2026-03-27T10:30:00.000Z",
        "completed_at": null,
        "duration": null,
        "error": null
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total_count": 142,
      "total_pages": 8
    }
  }
}

​
Response Fields

Each execution in the executions array includes:
FieldTypeDescription
run_idstringUnique execution identifier
statusstringExecution status: running, completed, or failed
started_atstringISO 8601 timestamp when the execution started
completed_atstring | nullISO 8601 timestamp when the execution finished (null if still running)
durationinteger | nullExecution duration in milliseconds (null if still running)
errorstring | nullError message if the execution failed

​
Credit Usage

This endpoint is free and does not consume credits.