---
title: "Returns a list of consensus events."
method: GET
path: "/consensus/events"
---

# Returns a list of consensus events.

`GET /consensus/events`

## Query parameters

- `limit` integer
- `offset` integer
- `block` integer
- `tx_index` integer
- `tx_hash` string
- `rel` string — An Oasis-style (bech32) address.
- `type` 'governance.proposal_executed' | 'governance.proposal_finalized' | 'governance.proposal_submitted' | 'governance.vote' | 'registry.entity' | 'registry.node_unfrozen' | 'registry.node' | 'registry.runtime' | 'registry.runtime_suspended' | 'roothash.execution_discrepancy' | 'roothash.executor_committed' | 'roothash.finalized' | 'roothash.message' | 'roothash.in_msg_processed' | 'staking.allowance_change' | 'staking.burn' | 'staking.escrow.add' | 'staking.escrow.debonding_start' | 'staking.escrow.reclaim' | 'staking.escrow.take' | 'staking.transfer'

## Response `200`

Consensus events matching the filters, sorted by most recent first.

- ConsensusEventList — A list of consensus events.
  - `total_count` integer, required — The total number of records that match the query, i.e. the number of records the query would return with limit=infinity.
  - `is_total_count_clipped` boolean, required — Whether total_count is clipped for performance reasons.
  - `events` ConsensusEvent[], required
    - `block` integer, required — The block height at which this event was generated.
    - `tx_index` integer — 0-based index of this event's originating transaction within its block. Absent if the event did not originate from a transaction.
    - `tx_hash` string — Hash of this event's originating transaction. Absent if the event did not originate from a transaction.
    - `roothash_runtime_id` string — The ID of the runtime to which the event relates, encoded in hex. Present only for events of type `roothash.*`.
    - `roothash_runtime` 'emerald' | 'sapphire' | 'pontusxtest' | 'pontusxdev' | 'cipher'
    - `roothash_runtime_round` integer — When applicable, the round in the runtime to which this event relates. Present only for events of type `roothash.*` except for `roothash.execution_discrepancy` before Eden.
    - `timestamp` string, date-time — The second-granular consensus time of this event's block.
    - `type` 'governance.proposal_executed' | 'governance.proposal_finalized' | 'governance.proposal_submitted' | 'governance.vote' | 'registry.entity' | 'registry.node_unfrozen' | 'registry.node' | 'registry.runtime' | 'registry.runtime_suspended' | 'roothash.execution_discrepancy' | 'roothash.executor_committed' | 'roothash.finalized' | 'roothash.message' | 'roothash.in_msg_processed' | 'staking.allowance_change' | 'staking.burn' | 'staking.escrow.add' | 'staking.escrow.debonding_start' | 'staking.escrow.reclaim' | 'staking.escrow.take' | 'staking.transfer', required
    - `body` object, required — The event contents. This spec does not encode the many possible types; instead, see [the Go API](https://pkg.go.dev/github.com/oasisprotocol/oasis-core/go/consensus/api/transaction/results#Event) of oasis-core. This object will conform to one of the `*Event` types two levels down the hierarchy, e.g. `TransferEvent` from `Event > staking.Event > TransferEvent`

## Other responses

- `400` — A human-readable error message.
- `404` — An empty response indicating that the requested resource was not found.
- `500` — A human-readable error message.

---

[API](https://skmtc.net/oasisprotocol/apis/oasis-nexus-api-v1.md) · [All operations](https://skmtc.net/oasisprotocol/apis/oasis-nexus-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oasisprotocol/oasis-nexus-api-v1/versions/a841981f8ee1/schema)