Skip to main content
GET
/
v2
/
flows
/
runs
curl --request GET \
  --url 'https://api.tableflow.com/v2/flows/runs?status=completed&limit=50' \
  --header 'Authorization: Bearer YOUR_API_KEY'

{
  "flow_runs": [
    {
      "id": "Wp7kRnT2mX4vQ9bL",
      "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": "hN3cYs8fKj6pA5wD",
      "flow_id": "dk4g1tUg1uHLs8YU",
      "workspace_id": "uT2bJNWN75YPU95r",
      "status": "processing",
      "status_history": [
        {
          "status": "processing",
          "time": 1682366328,
          "message": "Flow started via api"
        }
      ],
      "error": null,
      "metadata": {
        "customer_id": "67890"
      },
      "trigger_method": "api",
      "start_time": 1682366328,
      "end_time": null,
      "duration": 0,
      "drive_files": {},
      "created_at": 1682366328,
      "updated_at": 1682366328
    }
  ],
  "pagination": {
    "total": 250,
    "limit": 100,
    "offset": 0,
    "next_offset": 100,
    "filter": "all"
  }
}
Retrieves a paginated list of flow runs with optional filtering by flow ID or status.

​
Usage Notes

  • Results are paginated with a default limit of 100
  • Results are ordered by creation date (newest first)
  • Use filters to narrow down results by flow or status
  • The response includes complete flow run details

​
Request

​
flow_id
string
Filter by a specific flow ID to only return runs for that flow.
​
status
string
Filter by status. Valid values: processing, review, completed, or failed.
​
limit
number
default:"100"
Maximum number of results to return. Maximum value is 1000.
​
offset
number
default:"0"
Number of results to skip for pagination.

​
Response

{
  "flow_runs": [
    {
      "id": "Wp7kRnT2mX4vQ9bL",
      "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": "hN3cYs8fKj6pA5wD",
      "flow_id": "dk4g1tUg1uHLs8YU",
      "workspace_id": "uT2bJNWN75YPU95r",
      "status": "processing",
      "status_history": [
        {
          "status": "processing",
          "time": 1682366328,
          "message": "Flow started via api"
        }
      ],
      "error": null,
      "metadata": {
        "customer_id": "67890"
      },
      "trigger_method": "api",
      "start_time": 1682366328,
      "end_time": null,
      "duration": 0,
      "drive_files": {},
      "created_at": 1682366328,
      "updated_at": 1682366328
    }
  ],
  "pagination": {
    "total": 250,
    "limit": 100,
    "offset": 0,
    "next_offset": 100,
    "filter": "all"
  }
}

curl --request GET \
  --url 'https://api.tableflow.com/v2/flows/runs?status=completed&limit=50' \
  --header 'Authorization: Bearer YOUR_API_KEY'
​
flow_runs
array
required
Array of flow run objects
​
pagination
object
required
Pagination information