> ## Documentation Index > Fetch the complete documentation index at: https://docs.featherhq.com/llms.txt > Use this file to discover all available pages before exploring further. # List workflow executions > List agent workflow executions ## OpenAPI ````yaml get /api/v1/workflow/{workflowId}/executions openapi: 3.0.0 info: version: 1.0.0 title: Feather AI API servers: - url: https://prod.featherhq.com description: Production environment security: [] paths: /api/v1/workflow/{workflowId}/executions: get: tags: - Workflows summary: List workflow executions description: List agent workflow executions parameters: - schema: type: string format: uuid required: true name: workflowId in: path - schema: type: string enum: - CREATED - RUNNING - COMPLETED - FAILED - CANCELLED - PAUSED description: Filter by execution status required: false name: status in: query - schema: type: string description: Filter by customer lead ID required: false name: customerLeadId in: query - schema: type: string default: 'false' description: >- Include heavy fields (metadata, definition, variables) in the response required: false name: enriched in: query - schema: type: string required: false name: cursor in: query - schema: type: string default: '10' required: false name: limit in: query responses: '200': description: Agent workflow executions retrieved successfully content: application/json: schema: type: object properties: executions: type: array items: type: object properties: id: type: string format: uuid description: Execution ID workflowId: type: string format: uuid description: Workflow ID status: type: string enum: - CREATED - RUNNING - COMPLETED - FAILED - CANCELLED - PAUSED description: Execution status startedAt: type: string description: Execution start timestamp completedAt: type: string nullable: true description: Execution completion timestamp customerLeadId: type: string nullable: true description: Customer lead identifier primaryPhone: type: string nullable: true description: Primary phone number metadata: anyOf: - allOf: - type: object properties: firstName: type: string lastName: type: string - type: object additionalProperties: nullable: true - nullable: true description: >- Execution metadata (only included when enriched=true) variables: type: object additionalProperties: type: string description: Variables for the execution disposition: type: string nullable: true enum: - COULD_NOT_CONNECT - NO_ANSWER - LEFT_VOICEMAIL - VOICEMAIL_DETECTED - SILENCE_TIMEOUT - BAD_NUMBER - NOT_INTERESTED - WARM_TRANSFER - CALENDLY - DNC - ENDED - FRAUD - LINE_BUSY - TEXT_CONSENT - CALL_AGAIN description: Final execution disposition definition: type: object properties: steps: type: array items: type: object properties: id: type: string format: uuid type: type: string enum: - CALL - TEXT description: Type of workflow step order: type: integer minimum: 1 description: Order of execution (1-indexed) delayInSecs: type: integer minimum: 0 default: 0 description: >- Delay in seconds before executing this step finishOn: type: array items: type: string enum: - COULD_NOT_CONNECT - NO_ANSWER - LEFT_VOICEMAIL - VOICEMAIL_DETECTED - SILENCE_TIMEOUT - BAD_NUMBER - NOT_INTERESTED - WARM_TRANSFER - CALENDLY - DNC - ENDED - FRAUD - LINE_BUSY - TEXT_CONSENT - CALL_AGAIN default: [] description: >- Call end reasons that should finish the workflow agentId: type: string format: uuid description: Agent to use for this step leaveVoicemail: type: boolean default: false description: Whether to leave voicemail for call steps initialMessage: type: string maxLength: 1600 description: >- SMS message body for TEXT steps. Supports {{variableName}} interpolation. count: type: integer minimum: 1 default: 1 description: >- Number of times to repeat this step before moving to next required: - type - order - agentId minItems: 1 description: Workflow steps isInfinite: type: boolean default: false description: >- If true, workflow loops indefinitely using last step config when defined steps are exhausted required: - steps description: >- Workflow definition snapshot (only included when enriched=true) createdAt: type: string description: Creation timestamp stepIndex: type: number description: Current step index being processed nextRunAt: type: string nullable: true description: Next scheduled run timestamp priorityDate: type: string nullable: true description: Lead priority date required: - id - workflowId - status - startedAt - completedAt - customerLeadId - primaryPhone - disposition - createdAt description: List of executions pagination: type: object properties: limit: type: number minimum: 1 maximum: 100 default: 10 nextCursor: type: string required: - executions - pagination '400': description: Bad request content: application/json: schema: type: object properties: status: type: integer default: 400 message: type: string default: Bad request code: type: string enum: - BAD_REQUEST default: BAD_REQUEST success: type: boolean enum: - false default: false '500': description: Internal server error content: application/json: schema: type: object properties: status: type: integer default: 500 message: type: string default: Internal server error code: type: string enum: - INTERNAL_SERVER_ERROR default: INTERNAL_SERVER_ERROR success: type: boolean enum: - false default: false security: - ApiKey: [] components: securitySchemes: ApiKey: type: apiKey in: header name: X-API-Key ````