> ## 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 detailed information about a specific Cardano epoch including parameters, statistics, and block count.

# Specific epoch details



## OpenAPI

````yaml cardano/blockchain-indexer-api/openapi.json get /epochs/{epoch_no}
openapi: 3.0.3
info:
  title: Cardano - Blockchain Indexer API
  description: Core indexer endpoints dedicated to Cardano.
  contact:
    name: Maestro Blockchain Inc.
    url: https://gomaestro.org/
    email: info@gomaestro.org
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.txt
  version: v1.8.0
servers:
  - url: https://mainnet.gomaestro-api.org/v1
    description: Cardano Mainnet
  - url: https://preprod.gomaestro-api.org/v1
    description: Cardano Preprod
  - url: https://preview.gomaestro-api.org/v1
    description: Cardano Preview
security:
  - api-key: []
tags:
  - name: Maestro
paths:
  /epochs/{epoch_no}:
    get:
      tags:
        - Epochs
      summary: Specific epoch details
      description: Returns a summary of information about a specific epoch
      operationId: epoch_info
      parameters:
        - name: epoch_no
          in: path
          description: Epoch number to return information about
          required: true
          schema:
            type: integer
            format: int32
      responses:
        '200':
          description: Information about the requested epoch
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TimestampedEpochInfo'
              example:
                data:
                  epoch_no: 448
                  fees: '102017010232'
                  tx_count: 293800
                  blk_count: 21133
                  start_time: 1699739174
                  end_time: 1700171024
                  active_stake: '22973647279096705'
                  total_rewards: '10027944051413'
                  average_reward: '474515878'
                last_updated:
                  timestamp: '2023-11-23 13:42:12'
                  block_hash: >-
                    89e2f22f2441e7545bfd7b6f01a23be3b804c7cad4eea7dd2c989a679fa0138a
                  block_slot: 109180641
        '404':
          description: No results found
        '500':
          description: Internal server error
components:
  schemas:
    TimestampedEpochInfo:
      type: object
      description: >-
        Timestamped response. Returns the endpoint response data along with the
        chain-tip of the indexer, which details at which point in the chain's
        history the data was correct as-of.
      required:
        - data
        - last_updated
      properties:
        data:
          $ref: '#/components/schemas/EpochInfo'
        last_updated:
          $ref: '#/components/schemas/LastUpdated'
    EpochInfo:
      type: object
      description: Information summary of an epoch
      required:
        - epoch_no
        - fees
        - tx_count
        - blk_count
        - start_time
        - end_time
      properties:
        active_stake:
          type: string
          description: Total active stake for the epoch
          nullable: true
        average_reward:
          type: string
          description: Average reward for block producers during the epoch
          nullable: true
        blk_count:
          type: integer
          format: int32
          description: Total blocks in the epoch
        end_time:
          type: integer
          format: int64
          description: UNIX timestamp when the epoch ended
        epoch_no:
          type: integer
          format: int32
          description: Epoch number
        fees:
          type: string
          description: Total fees collected in the epoch
        start_time:
          type: integer
          format: int64
          description: UNIX timestamp when the epoch began
        total_rewards:
          type: string
          description: Total rewards earned by block producers during the epoch
          nullable: true
        tx_count:
          type: integer
          format: int32
          description: Total transactions in the epoch
    LastUpdated:
      type: object
      description: >-
        Details of the most recent block processed by the indexer (aka chain
        tip); that is, the data returned is correct as of this block in time.
      required:
        - timestamp
        - block_hash
        - block_slot
      properties:
        block_hash:
          type: string
          description: >-
            Hex-encoded hash of the most recently processed block (aka chain
            tip)
        block_slot:
          type: integer
          format: int64
          description: Absolute slot of the most recently processed block (aka chain tip)
          minimum: 0
        timestamp:
          type: string
          description: UTC timestamp of when the most recently processed block was minted
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: api-key
      description: Project API Key

````