> ## 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 confirmation status and chain position information for a specific Bitcoin block.

# Block Status



## OpenAPI

````yaml bitcoin/esplora-api/openapi.json get /block/{hash}/status
openapi: 3.0.3
info:
  title: Bitcoin - Esplora API
  version: 1.0.0
  description: >
    OpenAPI spec for core Esplora endpoints: blocks, transactions, addresses,
    mempool, fees, UTXO data and more.
servers:
  - url: https://xbt-mainnet.gomaestro-api.org/v0/esplora
  - url: https://xbt-testnet.gomaestro-api.org/v0/esplora
security:
  - api-key: []
paths:
  /block/{hash}/status:
    get:
      tags:
        - Blocks
      summary: Block Status
      description: >-
        Returns the confirmation status of a block. Available fields:
        in_best_chain (boolean, false for orphaned blocks), next_best (the hash
        of the next block, only available for blocks in the best chain).
      parameters:
        - name: hash
          in: path
          required: true
          description: The block hash to query
          schema:
            type: string
            example: 00000000000000000001b9dca5d168a8e959df258814beec486572e843fddee5
      responses:
        '200':
          description: Block status response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BlockStatus'
        '400':
          description: Invalid block hash
        '404':
          description: Block not found
components:
  schemas:
    BlockStatus:
      type: object
      properties:
        in_best_chain:
          type: boolean
          description: Whether the block is part of the best (main) chain
        next_best:
          type: string
          nullable: true
          description: Hash of the next block, if available
      required:
        - in_best_chain
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: api-key
      description: Project API Key

````