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

# Get Estimated Block Countdown by Block Number

> Retrieves the estimated time, in seconds, until a specified block is mined.

export const chain = '1';

<ResponseExample>
  ```json Example response theme={null}
  {
    "status":"1",
    "message":"OK",
    "result":{
      "CurrentBlock":"25788160",
      "CountdownBlock":"25789159",
      "RemainingBlock":"999",
      "EstimateTimeInSec":"12003.0"
    }
  }
  ```
</ResponseExample>


## OpenAPI

````yaml openapi/api-reference/endpoint/getblockcountdown.json GET /v2/api
openapi: 3.1.0
info:
  title: Get Estimated Block Countdown by Block Number
  version: 2.0.0
  description: Retrieves the estimated time, in seconds, until a specified block is mined.
  license:
    name: Etherscan API Terms
    url: https://etherscan.io/terms
servers:
  - url: https://api.etherscan.io
    description: Etherscan API.
security:
  - apiKey: []
paths:
  /v2/api:
    get:
      summary: Get Estimated Block Countdown by Block Number
      description: >-
        Retrieves the estimated time, in seconds, until a specified block is
        mined.
      operationId: getGetblockcountdown
      parameters:
        - name: chainid
          in: query
          required: true
          description: >-
            Chain ID you query, eg 1 for Ethereum, 42161 for Arbitrum from our
            [supported chains](/supported-chains).
          schema:
            type: string
          example: '1'
        - name: module
          in: query
          required: true
          description: Set to block for this endpoint.
          schema:
            type: string
            default: block
          example: block
        - name: action
          in: query
          required: true
          description: Set to getblockcountdown for this endpoint.
          schema:
            type: string
            default: getblockcountdown
          example: getblockcountdown
        - name: blockno
          in: query
          required: true
          description: Block number to estimate time remaining for.
          schema:
            type: integer
          example: 16701588
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: >-
                      1 if the request returned data, 0 otherwise. A status of 0
                      can indicate an error or a valid request that returned no
                      records.
                  message:
                    type: string
                    description: >-
                      OK on success, otherwise an error description such as
                      NOTOK. See [common error
                      messages](/common-error-messages).
                  result:
                    type: object
                    properties:
                      CurrentBlock:
                        type: string
                        description: >-
                          The most recent block number at the time of the
                          request.
                      CountdownBlock:
                        type: string
                        description: The target block number being counted down to.
                      RemainingBlock:
                        type: string
                        description: Number of blocks remaining until the target block.
                      EstimateTimeInSec:
                        type: string
                        description: >-
                          Estimated time until the target block is mined, in
                          seconds.
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: query
      name: apikey
      description: >-
        Enter your Etherscan API key, or [set one up](/set-up-your-api-key) if
        you don't have one.

````