---
title: "Get Events"
method: GET
path: "/events"
tags: ["Events"]
---

# Get Events

`GET /events`

Query on-chain events by their name in the specified blocks heights or block IDs.

## Query parameters

- `type` string, required — The qualified event type.
- `start_height` union
  - string, uint64
  - 'final' | 'sealed'
- `end_height` union
  - string, uint64
  - 'final' | 'sealed'
- `block_ids` Identifier[]
- `select` string[]
- `agreeing_executors_count` string, uint64
- `required_executor_ids` Identifier[]
- `include_executor_metadata` boolean

## Response `200`

OK

- BlockEvents
  - `block_id` string, hexadecimal — A 32-byte unique identifier for an entity.
  - `block_height` string
  - `block_timestamp` string, date-time
  - `events` Event[]
    - `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

- **2025-09-22** `ef376ce0d11f` — 4 info
  - added the new optional `query` request parameter `agreeing_executors_count`
  - added the new optional `query` request parameter `include_executor_metadata`
  - added the new optional `query` request parameter `required_executor_ids`
  - added the optional property `metadata` to the response with the `200` status
- **2025-09-18** `04fb304815f2` — 4 warning
  - deleted the `query` request parameter `agreeing_executors_count`
  - deleted the `query` request parameter `include_executor_metadata`
  - deleted the `query` request parameter `required_executor_ids`
  - removed the optional property `metadata` from the response with the `200` status
- **2025-08-07** `f20439279859` — 1 warning, 1 info
  - removed the optional property `executor_metadata` from the response with the `200` status
  - added the optional property `metadata` to the response with the `200` status
- **2025-08-06** `ebfa18ff435c` — 1 warning, 1 info
  - removed the optional property `execution_metadata` from the response with the `200` status
  - added the optional property `executor_metadata` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/onflow/apis/access-api/changes/events/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)