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

# Get Solana epochs metadata

> Fetches all epoch start and end times, first/last slot numbers, and epoch identifiers



## OpenAPI

````yaml /kamino-api.json get /epochs
openapi: 3.1.0
info:
  version: 1.0.0
  title: Kamino Public API
  description: >
    The Kamino API provides a comprehensive way to interact with Kamino without
    reading directly from the blockchain.


    The API also provides the ability to fetch data that might not be available
    from just reading the chain.


    The API is rate-limited for unauthenticated users. If you feel you need to
    make more requests or run into rate-limit issues, please reach out.
servers:
  - url: https://api.kamino.finance
security: []
paths:
  /epochs:
    get:
      tags:
        - Other
      summary: Get Solana epochs metadata
      description: >-
        Fetches all epoch start and end times, first/last slot numbers, and
        epoch identifiers
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Epoch'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Epoch:
      type: object
      properties:
        epoch:
          type: number
          description: Epoch identifier
          example: 678
        firstSlot:
          type: number
          description: First slot number of the epoch
          example: '123456789'
        lastSlot:
          type: number
          description: Last slot number of the epoch
          example: '123999999'
        startBlockTime:
          allOf:
            - $ref: '#/components/schemas/SnapshotDateTime'
            - description: UTC timestamp when the epoch started
              example: '2025-03-01T12:00:00.000Z'
        endBlockTime:
          allOf:
            - $ref: '#/components/schemas/SnapshotDateTime'
            - description: UTC timestamp when the epoch ended
              example: '2025-03-01T12:00:00.000Z'
      required:
        - epoch
        - firstSlot
        - lastSlot
        - startBlockTime
        - endBlockTime
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message for internal server failure
          example: An internal error occurred
      required:
        - error
      description: Internal server error response (500)
      example:
        error: An internal error occurred
    SnapshotDateTime:
      type: string
      format: date-time
      description: Timestamp of the metrics snapshot
      example: '2023-06-29T15:15:26.464Z'

````