---
title: "List executions"
method: GET
path: "/v1/executions"
tags: ["executions"]
---

# List executions

`GET /v1/executions`

## Request

- Base URL: `https://api.typenode.ai`
- URL: `https://api.typenode.ai/v1/executions`
- Auth: HTTP bearer

## Query parameters

- `workflow_id` string, uuid
- `status` string[]
- `from` string, date-time
- `to` string, date-time
- `limit` integer
- `after` string

## Response `200`

A page of execution summaries.

- object
  - `data` ExecutionSummary[], required
    - `created_at` string, date-time, required
    - `duration_ms` integer, nullable, required
    - `ended_at` string, date-time, nullable, required
    - `error` ExecutionError, required
      - `category` 'NODE_ERROR' | 'LOOP_ERROR' | 'PARTIAL_TRACE' | 'PUBLICATION_ERROR', nullable, required
      - `code` string, required
      - `message` string
    - `id` string, uuid, required
    - `is_test_run` boolean, required
    - `started_at` string, date-time, nullable, required
    - `status` 'queued' | 'running' | 'paused' | 'waiting' | 'success' | 'error' | 'cancelled', required
    - `step_count` integer, nullable, required
    - `trace_state` 'pending' | 'complete' | 'unavailable', required
    - `trace_unavailable_reason` 'terminated' | 'publication_failed' | 'not_published' | 'integrity' | 'not_started', nullable, required
    - `trigger_type` 'webhook' | 'email' | 'schedule' | 'manual', nullable, required
    - `workflow_id` string, uuid, required
    - `workflow_version_id` string, uuid, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: A singleton list query is repeated, the limit is invalid, or the cursor is malformed.
- `401`: Authentication required.
- `422`: The workflow, status, date, or date-range filter is invalid.
- `503`: Execution history is temporarily unavailable.
- `default`: An error occurred (RFC 9457 problem+json).

---

[API](https://skmtc.dev/typenode/apis/typenode-management-api.md) · [All operations](https://skmtc.dev/typenode/apis/typenode-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/typenode/apis/typenode-management-api/revisions/9b943024aa98?raw)