---
title: "GET /consensus/roothash_messages"
method: GET
path: "/consensus/roothash_messages"
---

# GET /consensus/roothash_messages

`GET /consensus/roothash_messages`

## Query parameters

- `limit` integer
- `offset` integer
- `runtime` 'emerald' | 'sapphire' | 'pontusxtest' | 'pontusxdev' | 'cipher', required
- `round` integer
- `type` 'staking.transfer' | 'staking.withdraw' | 'staking.add_escrow' | 'staking.reclaim_escrow' | 'registry.update_runtime' | 'governance.cast_vote' | 'governance.submit_proposal'
- `rel` string — An Oasis-style (bech32) address.

## Response `200`

A JSON object containing a list of roothash messages.

- RoothashMessageList
  - `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.
  - `roothash_messages` RoothashMessage[], required
    - `runtime` string, required — The runtime that sent this message.
    - `round` integer, required — The block round when the runtime sent this message.
    - `index` integer, required — The 0-based index of this message in the block.
    - `type` 'staking.transfer' | 'staking.withdraw' | 'staking.add_escrow' | 'staking.reclaim_escrow' | 'registry.update_runtime' | 'governance.cast_vote' | 'governance.submit_proposal'
    - `body` object — The "body" of a message is a structure within the `github.com/oasisprotocol/oasis-core/go/roothash/api/message` `Message` structure (https://pkg.go.dev/github.com/oasisprotocol/oasis-core/go/roothash/api/message#Message). For example, if the type is `staking.withdraw`, the body is the Go `Message` structure's `.Staking.Withdraw` field, which is a `github.com/oasisprotocol/oasis-core/go/staking/api` `Withdraw` structure (https://pkg.go.dev/github.com/oasisprotocol/oasis-core/go/staking/api#Withdraw), with `from` and `amount` fields in JSON.
    - `error_module` string — If executing this message resulted in an error, this is the error's module.
    - `error_code` integer — If executing this message resulted in an error, this is the error's code.
    - `result` unknown

## 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)