---
title: "Get Transaction Results by block"
method: GET
path: "/transaction_results"
tags: ["Transactions"]
---

# Get Transaction Results by block

`GET /transaction_results`

Retrieve a list of transaction results for a specific block. This includes results for submitted, system, and scheduled transactions.

## Query parameters

- `block_id` string, hexadecimal — A 32-byte unique identifier for an entity.
- `block_height` union
  - string, uint64
  - 'final' | 'sealed'
- `expand` string[]
- `select` string[]
- `agreeing_executors_count` string, uint64
- `required_executor_ids` Identifier[]
- `include_executor_metadata` boolean

## Response `200`

OK

- 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 succeded 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
  - `metadata` Metadata — Contains data about the node's state at the time of the request.
    - `executor_metadata` ExecutorMetadata — Contains data about the execution result used to serve the request.
      - `execution_result_id` string, hexadecimal — A 32-byte unique identifier for an entity.
      - `executor_ids` Identifier[]
  - `_links` Links
    - `_self` string

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

## Changes

> 50 revisions in range; 1 could not be searched.

- **2026-02-14** `036408ff3a0a` — 1 info
  - the `query` request parameter `block_id` became optional
- **2025-12-12** `b8655e364496` — 1 info
  - added the new optional `query` request parameter `block_height`
- **2025-12-03** `6a0127d384f1` — 1 info
  - endpoint added
- **2022-01-31** `7dfe2dc54c38` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/onflow/apis/access-api/changes/transaction_results/get.md)

---

[API](https://skmtc.dev/onflow/apis/access-api.md) · [All operations](https://skmtc.dev/onflow/apis/access-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/onflow/access-api/revisions/fd121c1fddf8/schema)