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

# Get Block Transactions

> Get transactions in specified block



## OpenAPI

````yaml GET /api/v2/getBlockTransactions
openapi: 3.1.1
info:
  title: TON HTTP API C++
  description: >
    This API enables HTTP access to TON blockchain - getting accounts and
    wallets information, looking up blocks and transactions, sending messages to
    the blockchain, calling get methods of smart contracts, and more.


    In addition to REST API, all methods are available through [JSON-RPC
    endpoint](#json%20rpc)  with `method` equal to method name and `params`
    passed as a dictionary.


    The response contains a JSON object, which always has a boolean field `ok`
    and either `error` or `result`. If `ok` equals true, the request was
    successful and the result of the query can be found in the `result` field.
    In case of an unsuccessful request, `ok` equals false and the error is
    explained in the `error`.


    API Key should be sent either as `api_key` query parameter or `X-API-Key`
    header
  version: 2.1.1
servers:
  - url: https://toncenter.com
    description: Mainnet
  - url: https://testnet.toncenter.com
    description: Testnet
security: []
tags:
  - name: utils
    description: Some useful methods
  - name: accounts
    description: Information about accounts
  - name: blocks
    description: Information about blocks
  - name: transactions
    description: Fetching and locating transactions
  - name: configuration
    description: Information about blockchain config
  - name: run method
    description: Run get-method of smart contracts
  - name: send
    description: Send data to blockchain
  - name: rpc
    description: JSON-RPC and POST endpoints
paths:
  /api/v2/getBlockTransactions:
    get:
      tags:
        - transactions
      summary: Get Block Transactions
      description: Get transactions in specified block
      operationId: getBlockTransactions_get
      parameters:
        - $ref: '#/components/parameters/workchain'
        - $ref: '#/components/parameters/shard'
        - $ref: '#/components/parameters/seqno'
        - $ref: '#/components/parameters/rootHashOptional'
        - $ref: '#/components/parameters/fileHashOptional'
        - $ref: '#/components/parameters/afterLtOptional'
        - $ref: '#/components/parameters/afterAccountHashOptional'
        - $ref: '#/components/parameters/countOptional'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    example: true
                  result:
                    title: BlockTransactions
                    allOf:
                      - $ref: '#/components/schemas/BlockTransactions'
                required:
                  - ok
                  - result
        default:
          $ref: '#/components/responses/default'
components:
  parameters:
    workchain:
      name: workchain
      in: query
      description: Workchain ID
      required: true
      schema:
        type: integer
        format: int32
    shard:
      name: shard
      in: query
      description: Shard ID
      required: true
      schema:
        type: string
        x-usrv-cpp-type: std::int64_t
    seqno:
      name: seqno
      in: query
      description: Seqno of a block
      required: true
      schema:
        type: integer
        format: int32
    rootHashOptional:
      name: root_hash
      in: query
      description: Root hash of a block
      required: false
      schema:
        type: string
        x-usrv-cpp-type: '#/components/schemas/TonHash'
    fileHashOptional:
      name: file_hash
      in: query
      description: File hash of a block
      required: false
      schema:
        type: string
        x-usrv-cpp-type: '#/components/schemas/TonHash'
    afterLtOptional:
      name: after_lt
      in: query
      description: Logical time of transaction to read after
      required: false
      schema:
        type: string
        x-usrv-cpp-format: std::int64_t
    afterAccountHashOptional:
      name: after_hash
      in: query
      description: >-
        Hash of account in this block in hex or base64 representation, which
        indicates transaction to read after
      required: false
      schema:
        type: string
        x-usrv-cpp-type: '#/components/schemas/TonAddrWithoutWorkchain'
    countOptional:
      name: count
      in: query
      description: Maximum number of items in response
      required: false
      schema:
        type: integer
        format: int64
        default: 40
  schemas:
    BlockTransactions:
      type: object
      additionalProperties: false
      description: Block transactions information
      properties:
        '@type':
          type: string
          enum:
            - blocks.transactions
          default: blocks.transactions
        id:
          $ref: '#/components/schemas/TonBlockIdExt'
          description: Identifier of the block containing the transactions
        req_count:
          type: integer
          description: Number of requested transactions
        incomplete:
          type: boolean
          description: Indicates if the transaction list is incomplete
        transactions:
          type: array
          description: List of short transaction identifiers
          items:
            $ref: '#/components/schemas/ShortTxId'
      required:
        - '@type'
        - id
        - req_count
        - incomplete
        - transactions
    TonBlockIdExt:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - ton.blockIdExt
          default: ton.blockIdExt
        workchain:
          type: integer
        shard:
          type: string
          x-usrv-cpp-type: std::int64_t
        seqno:
          type: integer
        root_hash:
          $ref: '#/components/schemas/TonHash'
        file_hash:
          $ref: '#/components/schemas/TonHash'
      required:
        - '@type'
        - workchain
        - shard
        - seqno
        - root_hash
        - file_hash
      description: Extended block identifier.
    ShortTxId:
      type: object
      additionalProperties: false
      description: Short transaction identifier
      properties:
        '@type':
          type: string
          enum:
            - blocks.shortTxId
          default: blocks.shortTxId
        mode:
          type: integer
          description: Transaction mode flags
        account:
          $ref: '#/components/schemas/TonAddr'
        lt:
          type: string
          description: Logical time of the transaction
          x-usrv-cpp-type: std::int64_t
        hash:
          $ref: '#/components/schemas/TonHash'
          description: Base64 hash of the transaction
      required:
        - '@type'
        - mode
        - account
        - lt
        - hash
    TonlibErrorResponse:
      type: object
      additionalProperties: false
      title: TonlibErrorResponse
      required:
        - ok
        - error
        - code
      properties:
        ok:
          type: boolean
          title: Ok
          default: false
        error:
          type: string
          title: Error description
        code:
          type: integer
          title: Error code
          minimum: 100
          maximum: 600
        '@extra':
          type: string
          title: Extra information
        jsonrpc:
          type: string
        id:
          type: string
    TonHash:
      type: string
      x-usrv-cpp-type: ton_http::types::ton_hash
    TonAddr:
      type: string
      x-usrv-cpp-type: ton_http::types::ton_addr
  responses:
    default:
      description: Tonlib error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/TonlibErrorResponse'
          examples:
            '409':
              summary: Not a token
              value:
                ok: false
                code: 409
                error: Smart contract is not a Jetton or NFT
                '@extra': ...
            '422':
              summary: Request validation error
              value:
                ok: false
                code: 422
                error: ...
                '@extra': ...
            '429':
              summary: Ratelimit exceeded
              value:
                ok: false
                code: 429
                error: ...
                '@extra': ...
            '504':
              summary: Tonlib timeout
              value:
                ok: false
                code: 504
                error: ...
                '@extra': ...

````