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

# List Executions

> List stored workflow executions owned by the authenticated user, newest first. Only runs executed with `persistence_mode=enabled` are stored and returned.



## OpenAPI

````yaml /api-rest/openapi/openapi_workflows.json get /v1/workflow/executions
openapi: 3.1.0
info:
  description: HTTP API for Bigdata Research Agent and Deep-Research capabilities
  title: Bigdata Research Agent API
  version: 1.0.0
servers:
  - description: Production server
    url: https://agents.bigdata.com
security: []
paths:
  /v1/workflow/executions:
    get:
      tags:
        - Workflow Executions
      summary: List Executions
      description: >-
        List stored workflow executions owned by the authenticated user, newest
        first. Only runs executed with `persistence_mode=enabled` are stored and
        returned.
      operationId: list_executions_v1_workflow_executions_get
      parameters:
        - in: query
          name: cursor
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Cursor
        - in: query
          name: limit
          required: false
          schema:
            default: 20
            title: Limit
            type: integer
        - in: query
          name: template_id
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Template Id
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExecutionListResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
        - API Key Authentication: []
components:
  schemas:
    ExecutionListResponse:
      description: A page of workflow executions owned by the authenticated user.
      properties:
        count:
          description: Number of matching executions.
          title: Count
          type: integer
        cursor:
          anyOf:
            - type: string
            - type: 'null'
          description: Pagination cursor for the next page; null on the last page.
          title: Cursor
        results:
          description: Executions in this page, newest first.
          items:
            $ref: '#/components/schemas/ExecutionSummary'
          title: Results
          type: array
      required:
        - count
        - results
      title: ExecutionListResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ExecutionSummary:
      description: Summary of a stored workflow execution.
      properties:
        date_created:
          description: When the execution was created.
          format: date-time
          title: Date Created
          type: string
        execution_id:
          description: Unique identifier for the execution.
          title: Execution Id
          type: string
        inputs:
          anyOf:
            - additionalProperties:
                $ref: '#/components/schemas/ExecutionInputValue'
              type: object
            - type: 'null'
          description: The inputs the run was executed with, keyed by input name.
          title: Inputs
        is_public:
          description: Whether the execution is shared through a public link.
          title: Is Public
          type: boolean
        last_updated:
          description: When the execution was last updated.
          format: date-time
          title: Last Updated
          type: string
        name:
          description: Human-readable name of the execution.
          title: Name
          type: string
        status:
          $ref: '#/components/schemas/ExecutionStatus'
          description: Current lifecycle status of the run.
        template_id:
          anyOf:
            - type: string
            - type: 'null'
          description: ID of the template that ran, if any.
          title: Template Id
      required:
        - execution_id
        - name
        - status
        - is_public
        - date_created
        - last_updated
      title: ExecutionSummary
      type: object
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
    ExecutionInputValue:
      description: One input the run was executed with, paired with its template type.
      properties:
        type:
          $ref: '#/components/schemas/WorkflowInputTypes'
          description: The input's declared type.
        value:
          description: The value supplied for this input.
          title: Value
          type: string
      required:
        - type
        - value
      title: ExecutionInputValue
      type: object
    ExecutionStatus:
      description: Lifecycle status of a stored workflow execution.
      enum:
        - pending
        - running
        - completed
        - error
        - cancelled
      title: ExecutionStatus
      type: string
    WorkflowInputTypes:
      description: Supported input types for workflow template placeholders.
      enum:
        - rp_entity_id
        - string
      title: WorkflowInputTypes
      type: string
  securitySchemes:
    API Key Authentication:
      description: API key for authentication.
      in: header
      name: X-API-Key
      type: apiKey

````