---
title: "EpochMsgs queries the messages of a given epoch"
method: GET
path: "/babylon/epoching/v1/epochs/{epoch_num}/messages"
tags: ["Query"]
---

# EpochMsgs queries the messages of a given epoch

`GET /babylon/epoching/v1/epochs/{epoch_num}/messages`

## Request

- The document declares no server URL.
- Auth: none declared

## Path parameters

- `epoch_num` string, uint64, required

## Query parameters

- `pagination.key` string, byte
- `pagination.offset` string, uint64
- `pagination.limit` string, uint64
- `pagination.count_total` boolean
- `pagination.reverse` boolean

## Response `200`

A successful response.

- object
  - `msgs` object[]
    - `tx_id` string: tx_id is the ID of the tx that contains the message as hex.
    - `msg_id` string: msg_id is the original message ID, i.e., hash of the marshaled message as hex.
    - `block_height` string, uint64
    - `block_time` string, date-time
    - `msg` string: msg is the actual message that is sent by a user and is queued by the epoching module as string.
    - `msg_type` string: msg_type is a string that identifies the type of the underlying message.
  - `pagination` object: PageResponse is to be embedded in gRPC response messages where the corresponding request message has used PageRequest. message SomeResponse { repeated Bar results = 1; PageResponse page = 2; }
    - `next_key` string, byte: next_key is the key to be passed to PageRequest.key to query the next page most efficiently. It will be empty if there are no more results.
    - `total` string, uint64

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/babylonlabs-io/apis/babylon-grpc-gateway-docs.md) - [All operations](https://skmtc.dev/babylonlabs-io/apis/babylon-grpc-gateway-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/babylonlabs-io/apis/babylon-grpc-gateway-docs/revisions/93a09c641887?raw)
