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

# Get the workflow run history



## OpenAPI

````yaml get /v4/workflows/{workflowId}/history
openapi: 3.0.3
info:
  title: Kadoa API
  version: 3.0.0
  contact:
    name: Support
    email: support@kadoa.com
servers:
  - url: https://api.kadoa.com
security: []
paths:
  /v4/workflows/{workflowId}/history:
    get:
      tags:
        - Workflows
      summary: Get the workflow run history
      parameters:
        - in: path
          name: workflowId
          required: true
          schema:
            type: string
          description: >-
            The unique identifier of the workflow whose runs history is to be
            retrieved
      responses:
        '200':
          description: History of workflow runs
          content:
            application/json:
              schema:
                type: object
                properties:
                  workflowId:
                    type: string
                    description: Unique identifier of the workflow
                  workflowRuns:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Unique identifier of the workflow run
                        state:
                          type: string
                          enum:
                            - IN_PROGRESS
                            - VALIDATING
                            - FINISHED
                            - FAILED
                            - NOT_SUPPORTED
                            - FAILED_INSUFFICIENT_FUNDS
                          description: >-
                            State of the workflow run. VALIDATING means the run
                            finished extracting but is held for QA review before
                            data is delivered.
                        startedAt:
                          type: string
                          format: date-time
                          description: Start date and time of the workflow run
                        finishedAt:
                          type: string
                          format: date-time
                          description: Finish date and time of the workflow run
                        screenshot:
                          type: string
                          description: Screenshot of the navigation during the workflow run
                        records:
                          type: integer
                          description: Number of records processed in the workflow run
                        errors:
                          type: array
                          description: Errors that occurred during the workflow run
                          items:
                            type: object
                            properties:
                              errorCode:
                                type: string
                                description: Error code identifying the type of error
                              message:
                                type: string
                                description: Human-readable error message
                              timestamp:
                                type: string
                                format: date-time
                                description: When the error occurred
                              screenshot:
                                type: string
                                description: Optional screenshot URL
                              context:
                                type: object
                                description: Additional context about the error
                                properties:
                                  url:
                                    type: string
                                    description: The URL where the error occurred
                                  httpStatus:
                                    type: integer
                                    description: HTTP status code if applicable
                                  retryCount:
                                    type: integer
                                    description: Number of retry attempts made
                                  details:
                                    type: string
                                    description: Additional error-specific details
                                  timestamp:
                                    type: string
                                    format: date-time
                                    description: When the error context was captured
                                additionalProperties: true
                        credits:
                          type: number
                          description: Number of credits used for this workflow run
        '401':
          description: Unauthorized access, either due to missing or invalid x-api-key
        '404':
          description: Workflow with the specified ID could not be found
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication

````