---
title: "Get scheduled transaction by ID"
method: GET
path: "/experimental/v1/scheduled/transaction/{id}"
tags: ["ScheduledTransactions"]
---

# Get scheduled transaction by ID

`GET /experimental/v1/scheduled/transaction/{id}`

Returns the scheduled transaction with the given ID.

## Path parameters

- `id` string, hexadecimal, required — A 32-byte unique identifier for an entity.

## Query parameters

- `expand` string[]
- `select` string[]

## Response `200`

The scheduled transaction.

- ScheduledTransaction
  - `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.
  - `created_transaction_id` string, hexadecimal, required — 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.
  - `created_at` string, date-time, required — Timestamp of the block in which the scheduled transaction was created (RFC 3339).
  - `completed_at` string, date-time — Timestamp of the block in which the scheduled transaction was executed or cancelled (RFC 3339). Populated only when status is `executed`, `cancelled`, or `failed`.
  - `is_placeholder` boolean — True if the scheduled transaction was created during bootstrapping based on the current chain state, not based on a protocol event. When true, block_height, transaction_id, tx_index, and event_index are absent.
  - `transaction` Transaction
    - `id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
    - `script` string, base64, required — Base64 encoded Cadence script.
    - `arguments` string[], required — Array of Base64 encoded arguments with in [JSON-Cadence interchange format](https://docs.onflow.org/cadence/json-cadence-spec/).
    - `reference_block_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
    - `gas_limit` string, uint64, required — The limit on the amount of computation a transaction is allowed to perform.
    - `payer` string, hexadecimal, required — The 8-byte address of an account.
    - `proposal_key` ProposalKey, required
      - `address` string, hexadecimal, required — The 8-byte address of an account.
      - `key_index` string, uint64, required
      - `sequence_number` string, uint64, required
    - `authorizers` Address[], required
    - `payload_signatures` TransactionSignature[], required
      - `address` string, hexadecimal, required — The 8-byte address of an account.
      - `key_index` string, uint64, required
      - `signature` string, byte, required — A variable length signature.
    - `envelope_signatures` TransactionSignature[], required
      - `address` string, hexadecimal, required — The 8-byte address of an account.
      - `key_index` string, uint64, required
      - `signature` string, byte, required — A variable length signature.
    - `result` TransactionResult
      - `block_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
      - `collection_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
      - `execution` 'Pending' | 'Success' | 'Failure' — This value indicates whether the transaction execution succeeded or not, this value should be checked when determining transaction success.
      - `status` 'Pending' | 'Finalized' | 'Executed' | 'Sealed' | 'Expired', required — This value indicates the state of the transaction execution. Only sealed and expired are final and immutable states.
      - `status_code` integer, required
      - `error_message` string, required — Provided transaction error in case the transaction wasn't successful.
      - `computation_used` string, uint64, required
      - `events` Event[], required
        - `type` string, required — The qualified event type.
        - `transaction_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
        - `transaction_index` string, uint64, required
        - `event_index` string, uint64, required
        - `payload` string, byte, required
      - `_links` Links
        - `_self` string
    - `_expandable` object, required
      - `result` string, uri
    - `_links` Links
      - `_self` string
  - `result` TransactionResult
    - `block_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
    - `collection_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
    - `execution` 'Pending' | 'Success' | 'Failure' — This value indicates whether the transaction execution succeeded or not, this value should be checked when determining transaction success.
    - `status` 'Pending' | 'Finalized' | 'Executed' | 'Sealed' | 'Expired', required — This value indicates the state of the transaction execution. Only sealed and expired are final and immutable states.
    - `status_code` integer, required
    - `error_message` string, required — Provided transaction error in case the transaction wasn't successful.
    - `computation_used` string, uint64, required
    - `events` Event[], required
      - `type` string, required — The qualified event type.
      - `transaction_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
      - `transaction_index` string, uint64, required
      - `event_index` string, uint64, required
      - `payload` string, byte, required
    - `_links` Links
      - `_self` string
  - `handler_contract` ContractDeployment
    - `contract_id` string, required — Address-qualified Cadence contract identifier (e.g. `A.1654653399040a61.EVM`).
    - `address` string, hexadecimal, required — The 8-byte address of an account.
    - `block_height` string, uint64 — Block height at which this deployment was applied.
    - `transaction_id` string, hexadecimal — A 32-byte unique identifier for an entity.
    - `tx_index` string, uint32 — Position of the deploying transaction within its block.
    - `event_index` string, uint32 — Position of the contract event within its transaction.
    - `code` string, byte — Base64-encoded Cadence source code of the contract deployed.
    - `code_hash` string, hexadecimal, required — Hex-encoded SHA3-256 hash of the contract code.
    - `is_placeholder` boolean — True if the deployment was created during bootstrapping based on the current chain state, not based on a protocol event. When true, block_height, transaction_id, tx_index, and event_index are absent.
    - `transaction` Transaction
      - `id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
      - `script` string, base64, required — Base64 encoded Cadence script.
      - `arguments` string[], required — Array of Base64 encoded arguments with in [JSON-Cadence interchange format](https://docs.onflow.org/cadence/json-cadence-spec/).
      - `reference_block_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
      - `gas_limit` string, uint64, required — The limit on the amount of computation a transaction is allowed to perform.
      - `payer` string, hexadecimal, required — The 8-byte address of an account.
      - `proposal_key` ProposalKey, required
        - `address` string, hexadecimal, required — The 8-byte address of an account.
        - `key_index` string, uint64, required
        - `sequence_number` string, uint64, required
      - `authorizers` Address[], required
      - `payload_signatures` TransactionSignature[], required
        - `address` string, hexadecimal, required — The 8-byte address of an account.
        - `key_index` string, uint64, required
        - `signature` string, byte, required — A variable length signature.
      - `envelope_signatures` TransactionSignature[], required
        - `address` string, hexadecimal, required — The 8-byte address of an account.
        - `key_index` string, uint64, required
        - `signature` string, byte, required — A variable length signature.
      - `result` TransactionResult
        - `block_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
        - `collection_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
        - `execution` 'Pending' | 'Success' | 'Failure' — This value indicates whether the transaction execution succeeded or not, this value should be checked when determining transaction success.
        - `status` 'Pending' | 'Finalized' | 'Executed' | 'Sealed' | 'Expired', required — This value indicates the state of the transaction execution. Only sealed and expired are final and immutable states.
        - `status_code` integer, required
        - `error_message` string, required — Provided transaction error in case the transaction wasn't successful.
        - `computation_used` string, uint64, required
        - `events` Event[], required
          - `type` string, required — The qualified event type.
          - `transaction_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
          - `transaction_index` string, uint64, required
          - `event_index` string, uint64, required
          - `payload` string, byte, required
        - `_links` Links
          - `_self` string
      - `_expandable` object, required
        - `result` string, uri
      - `_links` Links
        - `_self` string
    - `result` TransactionResult
      - `block_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
      - `collection_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
      - `execution` 'Pending' | 'Success' | 'Failure' — This value indicates whether the transaction execution succeeded or not, this value should be checked when determining transaction success.
      - `status` 'Pending' | 'Finalized' | 'Executed' | 'Sealed' | 'Expired', required — This value indicates the state of the transaction execution. Only sealed and expired are final and immutable states.
      - `status_code` integer, required
      - `error_message` string, required — Provided transaction error in case the transaction wasn't successful.
      - `computation_used` string, uint64, required
      - `events` Event[], required
        - `type` string, required — The qualified event type.
        - `transaction_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
        - `transaction_index` string, uint64, required
        - `event_index` string, uint64, required
        - `payload` string, byte, required
      - `_links` Links
        - `_self` string
    - `_expandable` object, required — Contains URI links for fields not included in the response. When a field is expanded via the `expand` query parameter, it appears inline and is removed from `_expandable`.
      - `code` string, uri — Link to fetch the Cadence source code of this deployment.
      - `transaction` string, uri — Link to fetch the full transaction that applied this deployment.
      - `result` string, uri — Link to fetch the transaction result.
    - `_links` Links
      - `_self` string
  - `_expandable` object, required — Contains URI links for fields not included in the response. When a field is expanded via the `expand` query parameter, it appears inline and is removed from `_expandable`.
    - `transaction` string, uri — Link to fetch the full transaction body of the transaction in which the scheduled transaction was executed.
    - `result` string, uri — Link to fetch the transaction result of the transaction in which the scheduled transaction was executed.
    - `handler_contract` string, uri — Link to fetch the Cadence contract that implements the transaction handler.
  - `_links` Links
    - `_self` string

## Other responses

- `400` — Bad request (invalid transaction ID).
- `404` — No scheduled transaction found for the given ID.
- `429` — Too many requests.

## Changes

- **2026-07-17** `9f7bc0dffcce` — 2 info
  - added the optional property `completed_at` to the response with the `200` status
  - added the required property `created_at` to the response with the `200` status
- **2026-03-03** `70791e5544f0` — 1 breaking, 1 info
  - the response property `handler_contract/code` became optional for the status `200`
  - added the optional property `handler_contract/_expandable/code` to the response with the `200` status
- **2026-02-28** `5dbfe72ac388` — 2 info
  - added the optional property `handler_contract/result` to the response with the `200` status
  - added the optional property `is_placeholder` to the response with the `200` status
- **2026-02-27** `85a743ac32f4` — 2 breaking, 12 info
  - removed the required property `handler_contract/body` from the response with the `200` status
  - removed the required property `handler_contract/identifier` from the response with the `200` status
  - added the optional property `handler_contract/_links` to the response with the `200` status
  - added the optional property `handler_contract/block_height` to the response with the `200` status
  - …10 more
- …earlier changes not shown

[Full history](https://skmtc.dev/onflow/apis/flow-experimental-api/changes/experimental/v1/scheduled/transaction/:id/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-service-production.skmtc.workers.dev/v1/apis/onflow/flow-experimental-api/revisions/9f7bc0dffcce/schema)