> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# masterchainBlockShards | TON v3

> The masterchainBlockShards endpoint retrieves information about the shards of a specific masterchain block in the TON blockchain. On TON v3.

The `masterchainBlockShards` endpoint retrieves information about the shards of a specific masterchain block in the TON blockchain.

<Note>
  **TON billing: full or archive by block age**

  This method is billed as archive (2 RUs) when the requested block is 128 or more seqno behind the tip, and full (1 RU) otherwise. See [Request units — TON method scope](/docs/request-units#ton-method-scope).
</Note>

## Parameters

* `seqno` (integer, required) — The sequence number of the masterchain block. Example: `40467413`.

## Response

* `shards` (array) — An array of shard objects, each containing:
  * `workchain` (integer) — The workchain ID.
  * `shard` (string) — The shard identifier.
  * `seqno` (integer) — The sequence number of the shard block.
  * `rootHash` (string) — The root hash of the shard block.
  * `fileHash` (string) — The file hash of the shard block.

## Use case

The `masterchainBlockShards` endpoint is useful for applications that need to analyze or track the state of shards within a specific masterchain block. This information can be valuable for:

1. Blockchain explorers that want to display detailed information about the structure of the TON blockchain at a specific point.
2. Analytics tools that need to monitor the distribution and state of shards across workchains for a given masterchain block.
3. Developers building applications that require knowledge of the shard structure for optimization or routing purposes.


## OpenAPI

````yaml openapi/ton_node_api/v3/getMasterchainBlockShards.json GET /masterchainBlockShards
openapi: 3.0.0
info:
  title: TON API
  version: 3.0.0
  description: API for interacting with The Open Network (TON) blockchain
servers:
  - url: >-
      https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3
security: []
paths:
  /masterchainBlockShards:
    get:
      tags:
        - Blockchain
      summary: Get Masterchain Block Shards
      description: Retrieves the shards of a specific masterchain block
      operationId: getMasterchainBlockShards
      parameters:
        - name: seqno
          in: query
          description: The sequence number of the masterchain block
          required: true
          schema:
            type: integer
            default: 40467413
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  shards:
                    type: array
                    items:
                      type: object
                      properties:
                        workchain:
                          type: integer
                          description: The workchain ID
                        shard:
                          type: string
                          description: The shard identifier
                        seqno:
                          type: integer
                          description: The sequence number of the shard block
                        rootHash:
                          type: string
                          description: The root hash of the shard block
                        fileHash:
                          type: string
                          description: The file hash of the shard block

````