> ## Documentation Index > Fetch the complete documentation index at: https://docs.hitl.sh/llms.txt > Use this file to discover all available pages before exploring further. # List a workflow's runs > A workflow's runs, newest first. Page with `before=`. ## OpenAPI ````yaml GET /api/workflows/{id}/executions openapi: 3.1.0 info: title: HITL API version: 1.0.0 description: >- Run the workflows you build in HITL, follow each run until a person has answered, and manage who reviews them. servers: - url: https://api.hitl.sh/v1 security: - bearerAuth: [] tags: - name: Workflows - name: Runs - name: Reviewers - name: Webhooks - name: Account - name: Uploads paths: /api/workflows/{id}/executions: get: tags: - Runs summary: List a workflow's runs description: A workflow's runs, newest first. Page with `before=`. operationId: runs-list parameters: - name: id in: path required: true description: The workflow id schema: type: string example: 6af2ce4e8207961501f59472 - name: status in: query required: false description: Only runs with this status schema: type: string enum: - running - pending_review - completed - failed - timed_out - name: limit in: query required: false description: 1 to 100, default 20 schema: type: integer example: 20 - name: before in: query required: false description: Only runs older than this execution id schema: type: string responses: '200': description: OK content: application/json: schema: type: object properties: error: type: boolean msg: type: string data: type: object properties: count: type: integer executions: type: array items: $ref: '#/components/schemas/Execution' next_before: type: string example: data: count: 2 executions: - id: 6af2cf07c6a9f1dc71efd5e7 workflow_id: 6af2ce4e8207961501f59472 workflow_name: Refund approval status: pending_review finished: false current_step: node_id: review-1 type: review label: Approve refund decisions: [] action_results: [] triggered_via: api started_at: '2026-11-10T08:00:07.121Z' completed_at: null - id: 6af2cf01c6a9f1dc71efd5e6 workflow_id: 6af2ce4e8207961501f59472 workflow_name: Refund approval status: pending_review finished: false current_step: node_id: review-1 type: review label: Approve refund decisions: [] action_results: [] triggered_via: api started_at: '2026-11-10T08:00:01.483Z' completed_at: null next_before: 6af2cf01c6a9f1dc71efd5e6 error: false msg: Executions retrieved '401': $ref: '#/components/responses/E401' '404': $ref: '#/components/responses/E404' components: schemas: Execution: type: object properties: id: type: string workflow_id: type: string workflow_name: type: string status: type: string enum: - running - pending_review - completed - failed - timed_out finished: type: boolean description: True for completed, failed and timed_out input: type: object additionalProperties: true description: What the run was started with current_step: type: object properties: node_id: type: string type: type: string label: type: string waiting_for: type: object description: 'While `pending_review`: the question the reviewers have' properties: request_id: type: string status: type: string request_text: type: string response_type: type: string response_config: type: object additionalProperties: true timeout_at: type: string format: date-time created_at: type: string format: date-time result: description: The last decision, once there is one decisions: type: array items: $ref: '#/components/schemas/Decision' action_results: type: array items: $ref: '#/components/schemas/ActionResult' trail: type: array items: type: object properties: node_id: type: string status: type: string enum: - done - waiting - failed - skipped at: type: string format: date-time error: type: string triggered_via: type: string enum: - api - webhook - email - schedule - manual - test callback_url: type: string callback: type: object properties: state: type: string enum: - queued - delivered - failed attempts: type: integer last_status: type: integer last_error: type: string last_attempt_at: type: string format: date-time delivered_at: type: string format: date-time started_at: type: string format: date-time completed_at: type: - string - 'null' format: date-time duration_seconds: type: number Decision: type: object properties: node_id: type: string description: The review step reviewer_id: type: string reviewer_name: type: string platform: type: string description: 'Where they answered: `mobile`, `web_portal`, `telegram`, ...' decision: description: >- The answer: an option value, a list of values, `true`/`false`, a number or text responded_at: type: string format: date-time response_time_seconds: type: number ActionResult: type: object properties: node_id: type: string type: type: string example: webhook status: type: string enum: - success - failed response: type: string description: Status code and the start of the response executed_at: type: string format: date-time Error: type: object required: - error - msg properties: error: type: boolean example: true msg: type: string description: What went wrong, in plain words code: type: string description: >- A machine-readable reason, when there is one (for example `confirmation_required`) responses: E401: description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/Error' example: error: true msg: Invalid API key E404: description: Not found, or not yours content: application/json: schema: $ref: '#/components/schemas/Error' example: error: true msg: Workflow not found securitySchemes: bearerAuth: type: http scheme: bearer description: 'Your API key: `hitl_live_…`' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.