---
title: "BtcCheckpointInfo returns checkpoint info for a given epoch"
method: GET
path: "/babylon/btccheckpoint/v1/{epoch_num}"
tags: ["Query"]
---

# BtcCheckpointInfo returns checkpoint info for a given epoch

`GET /babylon/btccheckpoint/v1/{epoch_num}`

## Request

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

## Path parameters

- `epoch_num` string, uint64, required

## Response `200`

A successful response.

- object
  - `info` object: BTCCheckpointInfoResponse contains all data about best submission of checkpoint for given epoch. Best submission is the submission which is deeper in btc ledger.
    - `epoch_number` string, uint64: EpochNumber of this checkpoint.
    - `best_submission_btc_block_height` integer
    - `best_submission_btc_block_hash` string
    - `best_submission_transactions` object[]
      - `index` integer: Index Bitcoin Transaction index in block.
      - `hash` string: Hash BTC Header hash as hex.
      - `transaction` string: transaction is the full transaction data as str hex.
      - `proof` string
    - `best_submission_vigilante_address_list` object[]
      - `submitter` string: submitter is the address of the checkpoint submitter to BTC, extracted from the checkpoint itself.
      - `reporter` string

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