# Get a paginated list of task executions

List task executions with optional filtering

Endpoint: GET /task-executions
Version: 1.0.0
Security: bearerAuth

## Query parameters:

  - `primaryScopeDataspaceId` (string)
    Optional filter by dataspace ID
    Example: "sds-abc12345"

  - `status` (string)
    Filter by execution status
    Enum: "started", "completed", "failed"

  - `workflowExecutionId` (string)
    Filter by workflow execution ID
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `taskDefinitionId` (string)
    Filter by task definition ID
    Example: "abc1234d-e89b-12d3-a456-426614174003"

  - `primaryScopeObjectId` (string)
    Filter by primary scope object ID
    Example: "456e7890-e89b-12d3-a456-426614174001"

  - `limit` (integer)
    Number of items to return
    Example: 20

  - `offset` (integer,null)
    Number of items to skip

## Response 200 fields (application/json):

  - `data` (array, required)
    Array of task execution objects

  - `data.id` (string, required)
    Example: "789e0123-e89b-12d3-a456-426614174002"

  - `data.workflowExecutionId` (string, required)
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `data.taskDefinitionId` (string, required)
    Example: "abc1234d-e89b-12d3-a456-426614174003"

  - `data.taskName` (string, required)
    Example: "Categorize Document"

  - `data.primaryScopeObjectId` (string, required)
    Example: "456e7890-e89b-12d3-a456-426614174001"

  - `data.primaryScopeDataspaceId` (string, required)
    Short dataspace ID with sds- prefix
    Example: "sds-abc12345"

  - `data.status` (string, required)
    Enum: "started", "completed", "failed"

  - `data.startedAt` (string, required)
    Example: "2025-01-15T10:30:30Z"

  - `data.completedAt` (string,null, required)
    Example: "2025-01-15T10:32:00Z"

  - `data.errorMessage` (string,null, required)
    Example: "Task failed due to invalid input format"

  - `totalCount` (integer, required)
    Total number of task executions matching the query
    Example: 42

  - `limit` (integer, required)
    Number of items requested
    Example: 20

  - `offset` (integer, required)
    Number of items skipped

## Response 400 fields (application/json):

  - `error` (string)
    Example: "Invalid status value"

## Response 500 fields (application/json):

  - `error` (string)
    Example: "Failed to retrieve task executions"