---
title: "List scheduled transactions"
method: GET
path: "/experimental/v1/scheduled"
tags: ["ScheduledTransactions"]
---

# List scheduled transactions

`GET /experimental/v1/scheduled`

Returns a paginated list of scheduled transactions, ordered descending by scheduled transaction identifier (newest first).
Results can be filtered by status, priority, time range, and transaction handler properties.

## Query parameters

- `cursor` string, base64 — Opaque pagination cursor from a previous response's `next_cursor` field.
- `limit` integer
- `statuses` ScheduledTransactionStatus[]
- `priority` 'low' | 'medium' | 'high' — The execution priority of a scheduled transaction.
- `start_time` string, date-time
- `end_time` string, date-time
- `handler_owner` string, hexadecimal — The 8-byte address of an account.
- `handler_type_identifier` string
- `handler_uuid` string, uint64
- `expand` string[]
- `select` string[]

## Response `200`

A page of scheduled transactions.

- ScheduledTransactionsResponse
  - `scheduled_transactions` ScheduledTransaction[], required
    - `id` string, uint64, required — Scheduler-assigned uint64 identifier.
    - `status` 'scheduled' | 'executed' | 'cancelled' | 'failed', required — The current lifecycle status of a scheduled transaction.
    - `priority` 'low' | 'medium' | 'high', required — The execution priority of a scheduled transaction.
    - `timestamp` string, required — Scheduled execution timestamp as a UFix64 decimal string.
    - `execution_effort` string, required — Execution effort estimate as a UFix64 decimal string.
    - `fees` string, required — Scheduled fee as a UFix64 decimal string.
    - `transaction_handler_owner` string, hexadecimal, required — The 8-byte address of an account.
    - `transaction_handler_type_identifier` string, required — Fully qualified Cadence type identifier of the transaction handler (e.g. `A.1654653399040a61.MyScheduler.Handler`).
    - `transaction_handler_uuid` string, uint64, required — Resource UUID of the transaction handler.
    - `transaction_handler_public_path` string — Public path of the transaction handler, if set.
    - `fees_returned` string — Fees returned on cancellation, as a UFix64 decimal string.
    - `fees_deducted` string — Fees deducted on cancellation, as a UFix64 decimal string.
    - `scheduled_transaction_id` string, hexadecimal — A 32-byte unique identifier for an entity.
    - `executed_transaction_id` string, hexadecimal — A 32-byte unique identifier for an entity.
    - `cancelled_transaction_id` string, hexadecimal — A 32-byte unique identifier for an entity.
    - `failed_transaction_id` string, hexadecimal — A 32-byte unique identifier for an entity.
    - `_links` Links
      - `_self` string
  - `next_cursor` string, base64 — Opaque pagination cursor from a previous response's `next_cursor` field.

## Other responses

- `400` — Bad request (invalid filter parameters, cursor, or limit).
- `429` — Too many requests.

## Changes

- **2026-02-21** `989dc7c309fd` — 8 breaking, 8 info
  - removed the enum value `High` from the `query` request parameter `priority`
  - removed the enum value `Low` from the `query` request parameter `priority`
  - removed the enum value `Medium` from the `query` request parameter `priority`
  - removed the enum value `Cancelled` from the property `items/` of the `query` request parameter `statuses`
  - …12 more
- **2026-02-21** `b8d39e9de270` — 1 info
  - endpoint added
- **2026-02-14** `556bb3c4f80a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/onflow/apis/flow-experimental-api/changes/experimental/v1/scheduled/get.md)

---

[API](https://skmtc.dev/onflow/apis/flow-experimental-api.md) · [All operations](https://skmtc.dev/onflow/apis/flow-experimental-api/llms.txt) · [OpenAPI document](https://skmtc.dev/onflow/apis/flow-experimental-api/revisions/989dc7c309fd?raw)