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

> Get comprehensive information about a specific Bitcoin block by height or hash including all transaction details.

# Block Info



## OpenAPI

````yaml bitcoin/node-rpc-api/openapi.json get /block/{height_or_hash}
openapi: 3.1.0
info:
  description: >-
    This API offers direct, low-latency access to Bitcoin full nodes via API
    (JSON-RPC protocol), giving developers reliable mempool visibility,
    transaction relay capabilities, and chain data without the hassle of running
    their own infrastructure.


    #### Key Features:

    - **Full JSON-RPC Support:** Access core Bitcoin functionality through RPC
    calls like `getblock`, `getrawtransaction`, `sendrawtransaction`, etc.

    - **Blockchain Data Retrieval:** Developers can fetch detailed information
    about blocks, transactions, and addresses.

    - **Mempool Insight:** Query unconfirmed transactions for faster, more
    responsive, real-time data access.

    - **High-Availability**: Enterprise-grade infrastructure ensures uptime,
    sync accuracy and fast transaction relay.


    #### Key Benefits for Developers:

    - Skip the operational complexity and computational overhead of maintaining
    self-hosted Bitcoin nodes.

    - Query mempool and chain data to power wallets, explorers, and backends
    with minimal latency.

    - Broadcast and verify transactions with trusted relay endpoints.

    - Build production-ready Bitcoin apps without worrying about node health,
    bandwidth, or reorg handling.
  title: Bitcoin - Node RPC API
  version: 0.1.1
servers:
  - description: Bitcoin Mainnet
    url: https://xbt-mainnet.gomaestro-api.org/v0/rpc
  - description: Bitcoin Testnet
    url: https://xbt-testnet.gomaestro-api.org/v0/rpc
security:
  - api-key: []
externalDocs:
  description: ''
  url: ''
paths:
  /block/{height_or_hash}:
    get:
      tags:
        - Blocks
      summary: Block Info
      description: |-
        Retrieve full or summary information for a specific block.
        Useful for analyzing individual blocks or resolving TX data inline.
      operationId: rpc_block_info
      parameters:
        - description: Block height or hash.
          in: path
          name: height_or_hash
          required: true
          schema:
            type: string
        - description: Page number for block transactions.
          example: 1
          in: query
          name: page
          schema:
            default: 1
            type: integer
        - description: Max number of block transactions per page.
          example: 100
          in: query
          name: count
          schema:
            default: 100
            type: integer
        - description: Verbose.
          example: false
          in: query
          name: verbose
          schema:
            default: false
            type: boolean
      responses:
        '200':
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/api_bitcoin.BitcoinBlockResponseBody'
                  - $ref: >-
                      #/components/schemas/api_bitcoin.BitcoinBlockVerboseResponseBody
          description: OK
        '400':
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/api_bitcoin.NodeRPCError'
                  - $ref: '#/components/schemas/api_bitcoin.APIError'
          description: Invalid height.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_bitcoin.APIError'
          description: Error getting block.
components:
  schemas:
    api_bitcoin.BitcoinBlockResponseBody:
      properties:
        data:
          $ref: '#/components/schemas/api_bitcoin.BitcoinBlock'
        last_updated:
          $ref: '#/components/schemas/api_bitcoin.LastUpdatedBlock'
      type: object
    api_bitcoin.BitcoinBlockVerboseResponseBody:
      properties:
        data:
          $ref: '#/components/schemas/api_bitcoin.BitcoinBlockVerbose'
        last_updated:
          $ref: '#/components/schemas/api_bitcoin.LastUpdatedBlock'
      type: object
    api_bitcoin.NodeRPCError:
      properties:
        code:
          description: Error code returned from the API request
          example: 0
          type: integer
        node rpc error:
          description: Error returned from the API request
          example: node rpc error
          type: string
      type: object
    api_bitcoin.APIError:
      properties:
        error:
          description: Error returned from the API request
          example: Bad Request
          type: string
      type: object
    api_bitcoin.BitcoinBlock:
      properties:
        bits:
          type: string
        chainwork:
          type: string
        confirmations:
          type: integer
        difficulty:
          type: number
        hash:
          type: string
        height:
          type: integer
        mediantime:
          type: integer
        merkleroot:
          type: string
        miner:
          $ref: '#/components/schemas/api_bitcoin.MinerInfo'
        nTx:
          type: integer
        nonce:
          type: integer
        previousblockhash:
          type: string
        size:
          type: integer
        strippedsize:
          type: integer
        time:
          type: integer
        tx:
          items:
            type: string
          type: array
          uniqueItems: false
        version:
          type: integer
        versionHex:
          type: string
        weight:
          type: integer
      type: object
    api_bitcoin.LastUpdatedBlock:
      properties:
        block_hash:
          type: string
        block_height:
          type: integer
      type: object
    api_bitcoin.BitcoinBlockVerbose:
      properties:
        bits:
          type: string
        chainwork:
          type: string
        confirmations:
          type: integer
        difficulty:
          type: number
        hash:
          type: string
        height:
          type: integer
        mediantime:
          type: integer
        merkleroot:
          type: string
        miner:
          $ref: '#/components/schemas/api_bitcoin.MinerInfo'
        nTx:
          type: integer
        nonce:
          type: integer
        previousblockhash:
          type: string
        size:
          type: integer
        strippedsize:
          type: integer
        time:
          type: integer
        tx:
          items:
            $ref: '#/components/schemas/api_bitcoin.BitcoinTransactionVerbose'
          type: array
          uniqueItems: false
        version:
          type: integer
        versionHex:
          type: string
        weight:
          type: integer
      type: object
    api_bitcoin.MinerInfo:
      properties:
        addresses:
          items:
            type: string
          type: array
          uniqueItems: false
        icon_url:
          type: string
        name:
          type: string
        tags:
          items:
            type: string
          type: array
          uniqueItems: false
        url:
          type: string
      type: object
    api_bitcoin.BitcoinTransactionVerbose:
      properties:
        blockhash:
          type: string
        blockheight:
          type: integer
        blocktime:
          type: integer
        confirmations:
          type: integer
        hash:
          type: string
        hex:
          type: string
        input_addresses:
          items:
            type: string
          type: array
          uniqueItems: false
        locktime:
          type: integer
        output_addresses:
          items:
            type: string
          type: array
          uniqueItems: false
        size:
          type: integer
        time:
          type: integer
        total_fees:
          type: number
        total_input_volume:
          type: number
        total_output_volume:
          type: number
        txid:
          type: string
        version:
          type: integer
        vin:
          items:
            $ref: '#/components/schemas/api_bitcoin.VinVerbose'
          type: array
          uniqueItems: false
        vout:
          items:
            $ref: '#/components/schemas/api_bitcoin.VoutVerbose'
          type: array
          uniqueItems: false
        vsize:
          type: integer
        weight:
          type: integer
      type: object
    api_bitcoin.VinVerbose:
      properties:
        address:
          type: string
        coinbase:
          type: string
        scriptSig:
          properties:
            asm:
              type: string
            hex:
              type: string
          type: object
        script_type:
          type: string
        sequence:
          type: integer
        txid:
          type: string
        txinwitness:
          items:
            type: string
          type: array
          uniqueItems: false
        value:
          type: number
        vout:
          type: integer
      type: object
    api_bitcoin.VoutVerbose:
      properties:
        address:
          type: string
        'n':
          type: integer
        scriptPubKey:
          properties:
            address:
              type: string
            asm:
              type: string
            desc:
              type: string
            hex:
              type: string
            type:
              type: string
          type: object
        script_type:
          type: string
        value:
          type: number
      type: object
  securitySchemes:
    api-key:
      description: Project API Key
      in: header
      name: api-key
      type: apiKey

````