> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dataraven.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Executions

> List executions for a task with filtering and pagination.

**Required Role:** VIEWER or higher

Returns executions ordered by queued_at descending (most recent first).

Query Parameters:
    - status: Filter by execution status (pending, queued, running, completed, failed, cancelled, dry_run_completed)
    - page: Page number (1-indexed)
    - limit: Items per page (max 100)



## OpenAPI

````yaml GET /v1/teams/{team_id}/tasks/{task_id}/executions
openapi: 3.1.0
info:
  title: Data Raven API
  description: Cloud-to-cloud data transfer platform powered by RClone
  version: 0.5.0
servers: []
security: []
paths:
  /v1/teams/{team_id}/tasks/{task_id}/executions:
    get:
      tags:
        - Executions
      summary: List Executions
      description: |-
        List executions for a task with filtering and pagination.

        **Required Role:** VIEWER or higher

        Returns executions ordered by queued_at descending (most recent first).

        Query Parameters:
            - status: Filter by execution status (pending, queued, running, completed, failed, cancelled, dry_run_completed)
            - page: Page number (1-indexed)
            - limit: Items per page (max 100)
      operationId: list_executions_v1_teams__team_id__tasks__task_id__executions_get
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Task Id
        - name: team_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Team Id
        - name: status_filter
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/ExecutionStatus'
              - type: 'null'
            description: Filter by execution status
            title: Status Filter
          description: Filter by execution status
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            description: Page number (1-indexed)
            default: 1
            title: Page
          description: Page number (1-indexed)
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            description: Items per page
            default: 50
            title: Limit
          description: Items per page
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedResponse_ExecutionResponse_'
        '404':
          description: Task not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    ExecutionStatus:
      type: string
      enum:
        - pending
        - running
        - completed
        - failed
        - cancelled
        - dry_run_completed
      title: ExecutionStatus
      description: Runtime execution status.
    PaginatedResponse_ExecutionResponse_:
      properties:
        data:
          items:
            $ref: '#/components/schemas/ExecutionResponse'
          type: array
          title: Data
        pagination:
          $ref: '#/components/schemas/PaginationResponse'
      type: object
      required:
        - data
        - pagination
      title: PaginatedResponse[ExecutionResponse]
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ExecutionResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        task_id:
          type: string
          format: uuid
          title: Task Id
        execution_number:
          type: integer
          title: Execution Number
        trigger:
          $ref: '#/components/schemas/ExecutionTrigger'
        status:
          $ref: '#/components/schemas/ExecutionStatus'
        is_dry_run:
          type: boolean
          title: Is Dry Run
        queued_at:
          type: string
          format: date-time
          title: Queued At
        started_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Started At
        completed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Completed At
        duration_seconds:
          anyOf:
            - type: integer
            - type: 'null'
          title: Duration Seconds
        stats:
          additionalProperties: true
          type: object
          title: Stats
        error_message:
          anyOf:
            - type: string
            - type: 'null'
          title: Error Message
        rclone_exit_code:
          anyOf:
            - type: integer
            - type: 'null'
          title: Rclone Exit Code
        log_file_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Log File Url
      type: object
      required:
        - id
        - task_id
        - execution_number
        - trigger
        - status
        - is_dry_run
        - queued_at
      title: ExecutionResponse
      description: Base response schema for task execution.
    PaginationResponse:
      properties:
        page:
          type: integer
          title: Page
        limit:
          type: integer
          title: Limit
        total:
          type: integer
          title: Total
        total_pages:
          type: integer
          title: Total Pages
      type: object
      required:
        - page
        - limit
        - total
        - total_pages
      title: PaginationResponse
      description: Pagination metadata in responses.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    ExecutionTrigger:
      type: string
      enum:
        - manual
        - scheduled
        - api
      title: ExecutionTrigger
      description: Execution trigger types.
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````