> ## 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 stake pool including registration details and current status.

# Stake pool information



## OpenAPI

````yaml cardano/blockchain-indexer-api/openapi.json get /pools/{pool_id}/info
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:
  /pools/{pool_id}/info:
    get:
      tags:
        - Pools
      summary: Stake pool information
      description: Returns current information about the specified pool
      operationId: pool_info
      parameters:
        - name: pool_id
          in: path
          description: Pool ID in bech32 format
          required: true
          schema:
            type: string
        - name: amounts-as-strings
          in: header
          description: Large numbers returned as strings if set to `true`
          required: false
          schema:
            type: string
            nullable: true
      responses:
        '200':
          description: Current information regarding the specified pool
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TimestampedPoolInfo'
              example:
                data:
                  pool_id_bech32: pool174mw7e20768e8vj4fn8y6p536n8rkzswsapwtwn354dckpjqzr8
                  pool_id_hex: f576ef654ff68f93b2554cce4d0691d4ce3b0a0e8742e5ba71a55b8b
                  active_epoch_no: 6
                  vrf_key_hash: >-
                    352196224497a0fd7bad52d113767660bf70f8b11a8c40c265f7bfb359ebe9ee
                  margin: 1
                  fixed_cost: 500000000
                  pledge: 100000000000000
                  reward_addr: >-
                    stake_test1uzkdwx64sjkt6xxtzye00y3k2m9wn5zultsguadaf4ggmssadyunp
                  owners:
                    - >-
                      stake_test1urcnqgzt2x8hpsvej4zfudehahknm8lux894pmqwg5qshgcrn346q
                  relays:
                    - dns: preprod-node.world.dev.cardano.org
                      srv: null
                      ipv4: null
                      ipv6: null
                      port: 30000
                  meta_url: null
                  meta_hash: null
                  meta_json: null
                  pool_status: registered
                  retiring_epoch: null
                  op_cert: >-
                    4838a036e2540d83eea0d28626f41566dbaf6d263bc9ad95e2ff89740a2a1b65
                  op_cert_counter: 5
                  active_stake: 1037439267850
                  sigma: '0.00432904657047742993'
                  block_count: 145101
                  live_pledge: 1000053629698
                  live_stake: 1037439267850
                  live_delegators: 13
                  live_saturation: '1.7000'
                last_updated:
                  timestamp: '2022-10-10 20:25:28'
                  block_hash: >-
                    5daa79fe4bf6581b59e5ebebb7a0ac6b2edd3ade5016e9db09ac67a7661010e5
                  block_slot: 32288194
        '404':
          description: No results found
        '500':
          description: Internal server error
components:
  schemas:
    TimestampedPoolInfo:
      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/PoolInfo'
        last_updated:
          $ref: '#/components/schemas/LastUpdated'
    PoolInfo:
      type: object
      description: Information summary of a stake pool
      required:
        - pool_id_bech32
        - pool_id_hex
        - active_epoch_no
        - margin
        - fixed_cost
        - pledge
        - owners
        - relays
        - active_stake
        - live_pledge
        - live_stake
        - live_delegators
      properties:
        active_epoch_no:
          type: integer
          format: int64
          description: Epoch when the update takes effect
        active_stake:
          $ref: '#/components/schemas/NumOrString'
        block_count:
          type: integer
          format: int64
          description: Number of blocks created
          nullable: true
          minimum: 0
        fixed_cost:
          $ref: '#/components/schemas/NumOrString'
        live_delegators:
          type: integer
          format: int64
          description: Number of current delegators
        live_pledge:
          $ref: '#/components/schemas/NumOrString'
        live_saturation:
          type: string
          description: Live saturation
          nullable: true
        live_stake:
          $ref: '#/components/schemas/NumOrString'
        margin:
          $ref: '#/components/schemas/NumOrString'
        meta_hash:
          type: string
          description: Hash of the pool metadata
          nullable: true
        meta_json:
          allOf:
            - $ref: '#/components/schemas/PoolMetaJson'
          nullable: true
        meta_url:
          type: string
          description: URL pointing to the pool metadata
          nullable: true
        op_cert:
          type: string
          description: Pool operational certificate
          nullable: true
        op_cert_counter:
          type: integer
          format: int64
          description: Operational certificate counter
          nullable: true
        owners:
          type: array
          items:
            type: string
          description: List of stake keys which control the pool
        pledge:
          $ref: '#/components/schemas/NumOrString'
        pool_id_bech32:
          type: string
          description: Bech32 encoded pool ID
        pool_id_hex:
          type: string
          description: Hex encoded pool ID
        pool_status:
          type: string
          description: Status of the pool
          nullable: true
        relays:
          type: array
          items:
            $ref: '#/components/schemas/Relay'
          description: Relays declared by the pool
        retiring_epoch:
          type: integer
          format: int32
          description: Epoch at which the pool will be retired
          nullable: true
        reward_addr:
          type: string
          description: Reward address associated with the pool
          nullable: true
        sigma:
          type: string
          description: Pool stake share
          nullable: true
        vrf_key_hash:
          type: string
          description: VRF key hash
          nullable: true
    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
    NumOrString:
      oneOf:
        - type: integer
          format: int64
          description: Unsigned 64-bit integer
          minimum: 0
        - type: integer
          description: Unsigned 128-bit integer
          minimum: 0
        - type: integer
          format: int64
          description: Signed 64-bit integer
        - type: number
          format: double
          description: 64-bit floating point number
        - type: string
          description: String representation of an integer or number
      description: >-
        Integer or number by default, or a string representation if the
        `amounts-as-strings` header is set to `true`
    PoolMetaJson:
      type: object
      description: JSON metadata associated with a stake pool
      required:
        - name
      properties:
        description:
          type: string
          description: Pool description
          nullable: true
        homepage:
          type: string
          description: Pool home page URL
          nullable: true
        name:
          type: string
          description: Pool name
        ticker:
          type: string
          description: Pool ticker symbol
          nullable: true
    Relay:
      type: object
      description: Stake pool relay
      properties:
        dns:
          type: string
          nullable: true
        ipv4:
          type: string
          nullable: true
        ipv6:
          type: string
          nullable: true
        port:
          type: integer
          format: int32
          nullable: true
        srv:
          type: string
          nullable: true
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: api-key
      description: Project API Key

````