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

# masterchainBlockShardState | TON v3

> The masterchainBlockShardState method retrieves the shard state of a specific masterchain block in the TON blockchain. TON v3 via Chainstack.

The `masterchainBlockShardState` method retrieves the shard state of a specific masterchain block in the TON blockchain. This method provides information about the shards associated with the given masterchain block.

<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.
  * `root_hash` (string) — The root hash of the shard block.
  * `file_hash` (string) — The file hash of the shard block.

## Use case

The `masterchainBlockShardState` method is useful for applications that need to analyze or track the state of shards within the TON blockchain. This information can be valuable for:

1. Blockchain explorers that want to display detailed information about the structure of the TON blockchain.
2. Analytics tools that need to monitor the distribution of shards across workchains.
3. Developers building applications that require knowledge of the current state of shards for optimization or routing purposes.


## OpenAPI

````yaml openapi/ton_node_api/v3/getMasterchainBlockShardState.json GET /masterchainBlockShardState
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:
  /masterchainBlockShardState:
    get:
      tags:
        - Blockchain
      summary: Get Masterchain Block Shard State
      description: Retrieves the shard state of a specific masterchain block
      operationId: getMasterchainBlockShardState
      parameters:
        - name: seqno
          in: query
          description: The sequence number of the masterchain block
          required: true
          schema:
            type: integer
            default: 40467413
            example: 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
                        root_hash:
                          type: string
                          description: The root hash of the shard block
                        file_hash:
                          type: string
                          description: The file hash of the shard block

````