Skip to content
Factflow

List Executions

GET
/api/v1/executions

List pipeline executions with filters and pagination.

Args: service: Execution service (injected) status: Filter by status (running, completed, failed, cancelled, interrupted) config_id: Filter by configuration ID started_after: Filter by minimum start time started_before: Filter by maximum start time limit: Maximum number of results per page (default: 100) offset: Number of records to skip for pagination (default: 0)

Returns: Paginated list of executions matching filters with total count

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
status
Any of:
string
Allowed values: running completed failed cancelled interrupted

Filter by status

config_id
Any of:
string format: uuid

Filter by configuration

started_after
Any of:
string format: date-time

Filter by minimum start time

started_before
Any of:
string format: date-time

Filter by maximum start time

tag
Any of:
string

Filter by exact tag match

limit
Limit

Maximum results per page

integer
default: 100 >= 1 <= 1000

Maximum results per page

offset
Offset

Number of records to skip

integer
0

Number of records to skip

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

ExecutionListResponse

Paginated list of pipeline executions.

object
total
required
Total

Total number of executions matching filters

integer
limit
required
Limit

Maximum entries per page

integer
offset
required
Offset

Offset from start

integer
has_more
required
Has More

Whether more executions exist

boolean
executions
required
Executions

List of executions

Array<object>
ExecutionResponse

Pipeline execution response.

Storage paths use execution id (UUID v7) directly.

object
id
required
Id

Execution UUID (used for storage paths)

string format: uuid
config_id
required
Config Id

Configuration ID

string format: uuid
status
required
Status

Current status

string
Allowed values: running completed failed cancelled interrupted
started_at
required
Started At

Start timestamp

string format: date-time
completed_at
Any of:
string format: date-time
parent_execution_id
Any of:
string format: uuid
replay_source
Any of:
string
Allowed values: storage lineage manual
tag
Any of:
string

422

Section titled “422 ”

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object