---
title: "ListEvidences queries is a range query for evidences"
method: GET
path: "/babylon/finality/v1/evidences"
tags: ["Query"]
---

# ListEvidences queries is a range query for evidences

`GET /babylon/finality/v1/evidences`

## Request

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

## Query parameters

- `start_height` string, uint64
- `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: QueryListEvidencesResponse is the response type for the Query/ListEvidences RPC method.
  - `evidences` object[]
    - `fp_btc_pk_hex` string
    - `block_height` string, uint64
    - `pub_rand` string, byte
    - `canonical_app_hash` string, byte
    - `fork_app_hash` string, byte
    - `canonical_finality_sig` string, byte
    - `fork_finality_sig` string, byte
  - `pagination` object: pagination defines the pagination in the response.
    - `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.

## Changes

- **2025-01-20** `c22c13d24c41`: 1 info
  - endpoint added
- **2023-02-14** `56ada4e129e1`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/babylonlabs-io/apis/babylon-grpc-gateway-docs/changes/babylon/finality/v1/evidences/get.md)

---

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