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

# getBlockTransactions | TON v2

> The getBlockTransactions method retrieves transactions from a specific block in the TON blockchain. Use it on TON v2 via Chainstack.

The `getBlockTransactions` method retrieves transactions from a specific block in the TON blockchain. This method allows you to fetch transaction details for a given block, specified by its workchain, shard, and sequence number.

<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

* `workchain` (integer, required) — The ID of the workchain. Example: `-1` for the masterchain.
* `shard` (string, required) — The ID of the shard. Example: `"-9223372036854775808"` for the masterchain.
* `seqno` (integer, required) — The sequence number of the block. Example: `39064874`.
* `count` (integer, optional) — The maximum number of transactions to return. Default: `40`.

## JSON-RPC

```shell Shell theme={"system"}
curl -X POST \
  'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/jsonRPC' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBlockTransactions",
    "params": {
      "workchain": -1,
      "shard": "-9223372036854775808",
      "seqno": 39064874,
      "count": 40
    }
  }'
```

## Response

* `id` (object) — The identifier of the block, containing:
  * `workchain` (integer) — The workchain ID of the block.
  * `shard` (string) — The shard ID of the block.
  * `seqno` (integer) — The sequence number of the block.
  * `root_hash` (string) — The root hash of the block.
  * `file_hash` (string) — The file hash of the block.
* `transactions` (array of objects) — An array of transaction objects, each containing:
  * `account` (string) — The account address involved in the transaction.
  * `hash` (string) — The transaction hash.
  * `lt` (string) — The logical time of the transaction.
* `incomplete` (boolean) — Indicates if the returned list of transactions is incomplete.

## Use case

A possible use case for the `getBlockTransactions` method in TON is for blockchain explorers, analytical tools, or any application that needs to examine transactions within specific blocks. This method can be used to:

1. Display transaction details for a given block in a block explorer.
2. Analyze transaction patterns or volumes within specific blocks or shards.
3. Monitor specific accounts by tracking their transactions across blocks.
4. Implement custom indexing or caching mechanisms for transaction data.


## OpenAPI

````yaml openapi/ton_node_api/v2/getBlockTransactions.json GET /getBlockTransactions
openapi: 3.0.0
info:
  title: getBlockTransactions example
  version: 1.0.0
  description: >-
    This is an API example for getBlockTransactions, a method to retrieve
    transactions from a specific block in the TON blockchain.
servers:
  - url: >-
      https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2
security: []
paths:
  /getBlockTransactions:
    get:
      tags:
        - TON Operations
      summary: getBlockTransactions
      operationId: getBlockTransactions
      parameters:
        - name: workchain
          in: query
          required: true
          description: The workchain ID
          schema:
            type: integer
            default: -1
          example: -1
        - name: shard
          in: query
          required: true
          description: The shard ID
          schema:
            type: string
            default: '-9223372036854775808'
          example: '-9223372036854775808'
        - name: seqno
          in: query
          required: true
          description: The sequence number of the block
          schema:
            type: integer
            default: 39064874
          example: 39064874
        - name: count
          in: query
          required: false
          description: The maximum number of transactions to return
          schema:
            type: integer
            default: 40
          example: 40
      responses:
        '200':
          description: Transactions from the specified block
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: object
                    properties:
                      workchain:
                        type: integer
                        description: The workchain ID of the block
                      shard:
                        type: string
                        description: The shard ID of the block
                      seqno:
                        type: integer
                        description: The sequence number of the block
                      root_hash:
                        type: string
                        description: The root hash of the block
                      file_hash:
                        type: string
                        description: The file hash of the block
                  transactions:
                    type: array
                    items:
                      type: object
                      properties:
                        account:
                          type: string
                          description: The account address involved in the transaction
                        hash:
                          type: string
                          description: The transaction hash
                        lt:
                          type: string
                          description: The logical time of the transaction
                  incomplete:
                    type: boolean
                    description: Indicates if the returned list is incomplete

````