GET
/
v2
/
flows
/
{id}
/
runs
curl --request GET \
  --url https://api.tableflow.com/v2/flows/dk4g1tUg1uHLs8YU/runs \
  --header 'Authorization: Bearer YOUR_API_KEY'
[
  {
    "id": "fr_abc123def456",
    "flow_id": "dk4g1tUg1uHLs8YU",
    "workspace_id": "uT2bJNWN75YPU95r",
    "status": "completed",
    "status_history": [
      {
        "status": "processing",
        "time": 1682366228,
        "message": "Flow started via api"
      },
      {
        "status": "completed",
        "time": 1682366258,
        "message": "Flow completed successfully"
      }
    ],
    "error": null,
    "metadata": {
      "customer_id": "12345",
      "order_number": "PO-2024-001"
    },
    "trigger_method": "api",
    "start_time": 1682366228,
    "end_time": 1682366258,
    "duration": 30000,
    "drive_files": {},
    "created_at": 1682366228,
    "updated_at": 1682366258
  },
  {
    "id": "fr_def456ghi789",
    "flow_id": "dk4g1tUg1uHLs8YU",
    "workspace_id": "uT2bJNWN75YPU95r",
    "status": "failed",
    "status_history": [
      {
        "status": "processing",
        "time": 1682365228,
        "message": "Flow started via manual"
      },
      {
        "status": "failed",
        "time": 1682365258,
        "message": "Extraction step 'Extract Invoice' failed: Template not found"
      }
    ],
    "error": "Extraction step 'Extract Invoice' failed: Template not found",
    "metadata": {
      "customer_id": "54321"
    },
    "trigger_method": "manual",
    "start_time": 1682365228,
    "end_time": 1682365258,
    "duration": 30000,
    "drive_files": {},
    "created_at": 1682365228,
    "updated_at": 1682365258
  }
]

Retrieves all flow runs for a specific flow.

​
Usage Notes

  • Returns all runs without pagination
  • Results are ordered by creation date (newest first)
  • The flow must belong to your workspace

​
Request

​
id
string
required

The ID of the flow

​
Response

[
  {
    "id": "fr_abc123def456",
    "flow_id": "dk4g1tUg1uHLs8YU",
    "workspace_id": "uT2bJNWN75YPU95r",
    "status": "completed",
    "status_history": [
      {
        "status": "processing",
        "time": 1682366228,
        "message": "Flow started via api"
      },
      {
        "status": "completed",
        "time": 1682366258,
        "message": "Flow completed successfully"
      }
    ],
    "error": null,
    "metadata": {
      "customer_id": "12345",
      "order_number": "PO-2024-001"
    },
    "trigger_method": "api",
    "start_time": 1682366228,
    "end_time": 1682366258,
    "duration": 30000,
    "drive_files": {},
    "created_at": 1682366228,
    "updated_at": 1682366258
  },
  {
    "id": "fr_def456ghi789",
    "flow_id": "dk4g1tUg1uHLs8YU",
    "workspace_id": "uT2bJNWN75YPU95r",
    "status": "failed",
    "status_history": [
      {
        "status": "processing",
        "time": 1682365228,
        "message": "Flow started via manual"
      },
      {
        "status": "failed",
        "time": 1682365258,
        "message": "Extraction step 'Extract Invoice' failed: Template not found"
      }
    ],
    "error": "Extraction step 'Extract Invoice' failed: Template not found",
    "metadata": {
      "customer_id": "54321"
    },
    "trigger_method": "manual",
    "start_time": 1682365228,
    "end_time": 1682365258,
    "duration": 30000,
    "drive_files": {},
    "created_at": 1682365228,
    "updated_at": 1682365258
  }
]
curl --request GET \
  --url https://api.tableflow.com/v2/flows/dk4g1tUg1uHLs8YU/runs \
  --header 'Authorization: Bearer YOUR_API_KEY'
​
flow_runs
array

Array of flow run objects