# completedBlockHeights

**Type:** GraphQL queries

**Description:**
Retrieve a list of **completed block heights** across one or more chains, starting from a given point.

In Kadena’s braided multi-chain architecture, a **block height** is considered *completed* only when **all chains** have successfully produced a block at that height.
Since each chain progresses independently, some chains may temporarily lag behind others. This query ensures that only *globally finalized* heights — where every specified chain has reached that block height — are returned.

This is particularly useful for building indexers, explorers, and analytics tools that require consistent cross-chain data.
You can specify how many completed heights to return with `heightCount`.

## Arguments
- chainIds (String): The chain IDs to include when checking for completed heights.
Only heights where all of these chains have produced a block will be returned.
- completedHeights (Boolean): Whether to include only completed heights.
Defaults to `true`.
If set to `false`, the query may include heights that are not yet completed across all chains.
- heightCount (Int): The maximum number of sequential completed heights to return per query.
Results are always returned without gaps, starting from the most recent completed height and moving backward if no pagination arguments are provided.

Examples:
- If completed heights are `101`, `102`, `103`, `104`, and `105`, and you set `heightCount: 3` without pagination, the query returns the 3 most recent completed heights: `105`, `104`, `103`.
- If you set `heightCount: 10` in the same scenario, the query still returns only the 5 available heights: `105`, `104`, `103`, `102`, `101`.
- after (String): Cursor to start paginating **after** a specific result.
Used for forward pagination.
- before (String): Cursor to start paginating **before** a specific result.
Used for backward pagination.
- first (Int): Maximum number of results to return when paginating forward.
- last (Int): Maximum number of results to return when paginating backward.

## Response
**Type:** QueryCompletedBlockHeightsConnection
**Description:**
undefined

### Fields
- edges (QueryCompletedBlockHeightsConnectionEdge)
- pageInfo (PageInfo)