> ## 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 update history for a Cardano stake pool including registration changes and parameter modifications.

# Stake pool updates



## OpenAPI

````yaml cardano/blockchain-indexer-api/openapi.json get /pools/{pool_id}/updates
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}/updates:
    get:
      tags:
        - Pools
      summary: Stake pool updates
      description: Returns a list of updates relating to the specified pool
      operationId: pool_updates
      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: List of pool updates relating to the specified pool
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TimestampedPoolUpdates'
              example:
                data:
                  - tx_hash: >-
                      877091a2e789309eecd7d6a15721c6ad8ffdfdbdf8e1fd172f81ce54b7e26f15
                    block_time: 1619787462
                    pool_id_bech32: pool10qrz84cvz95zg8saf43ruhs5ulczuuqm2d3jn6d8xkkkzgzfje7
                    pool_id_hex: 780623d70c1168241e1d4d623e5e14e7f02e701b536329e9a735ad61
                    active_epoch_no: 265
                    vrf_key_hash: >-
                      66b11dc1264c5758a202ecea777d12329d6ca3ff111e9a161026d4ccd782238f
                    margin: 0.015
                    fixed_cost: 340000000
                    pledge: 44325545672
                    reward_addr: >-
                      stake1u9dh8mls26d6aq68v5nmmkeh5eq563m3w5mnytqppl6l66swz236x
                    owners:
                      - >-
                        stake1u9dh8mls26d6aq68v5nmmkeh5eq563m3w5mnytqppl6l66swz236x
                    relays:
                      - dns: relay1.adappt.online
                        srv: null
                        ipv4: null
                        ipv6: null
                        port: 3001
                      - dns: relay2.adappt.online
                        srv: null
                        ipv4: null
                        ipv6: null
                        port: 3001
                    meta_url: https://adappt.online/pool_metadata.json
                    meta_hash: >-
                      be9033a437ba8e8c9ad7e072e71b1afca66ab18225d39d5e9de3d38e1e088f8d
                    meta_json:
                      name: Adappt Online
                      ticker: ADAPT
                      homepage: https://adappt.online
                      description: >-
                        Adappt Online pool supports Cardano and the concept of
                        DApps. On-premise servers with 24/7 monitoring.
                    pool_status: registered
                    retiring_epoch: null
                  - tx_hash: >-
                      d4c54ce8b1edc60a18914a461c555d9784f8c6599321926302df31008b0c6c02
                    block_time: 1596465191
                    pool_id_bech32: pool10qrz84cvz95zg8saf43ruhs5ulczuuqm2d3jn6d8xkkkzgzfje7
                    pool_id_hex: 780623d70c1168241e1d4d623e5e14e7f02e701b536329e9a735ad61
                    active_epoch_no: 210
                    vrf_key_hash: >-
                      66b11dc1264c5758a202ecea777d12329d6ca3ff111e9a161026d4ccd782238f
                    margin: 0.03
                    fixed_cost: 340000000
                    pledge: 2061750060728
                    reward_addr: >-
                      stake1u9dh8mls26d6aq68v5nmmkeh5eq563m3w5mnytqppl6l66swz236x
                    owners:
                      - >-
                        stake1u9dh8mls26d6aq68v5nmmkeh5eq563m3w5mnytqppl6l66swz236x
                      - >-
                        stake1u95f0rfdr6phfpym6gn5rcfes66dkht0u49d8uhhq53agwc62e5xj
                      - >-
                        stake1u8px8vy3lwk8me2umaf2n06jx6q0ghaa0vkehjtg5rqm3yqtckhmm
                    relays:
                      - dns: adappt.online
                        srv: null
                        ipv4: null
                        ipv6: null
                        port: 3001
                    meta_url: https://adappt.online/pool_metadata.json
                    meta_hash: >-
                      5a040f5e31f4fef8030fb9f996ac2a7f19852c071dcfd1da6fa0a8416d8fea5f
                    meta_json: null
                    pool_status: registered
                    retiring_epoch: null
                last_updated:
                  timestamp: '2022-10-10 20:25:28'
                  block_hash: >-
                    4cede7843465d55e260722845c3694970500def738245d340501dfc02ae11517
                  block_slot: 96405387
        '500':
          description: Internal server error
components:
  schemas:
    TimestampedPoolUpdates:
      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/PoolUpdates'
        last_updated:
          $ref: '#/components/schemas/LastUpdated'
    PoolUpdates:
      type: array
      items:
        $ref: '#/components/schemas/PoolUpdate'
      description: List of updates to a stake pool
    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
    PoolUpdate:
      type: object
      description: Update to a stake pool
      required:
        - tx_hash
        - pool_id_bech32
        - pool_id_hex
        - margin
        - fixed_cost
        - pledge
      properties:
        active_epoch_no:
          type: integer
          format: int64
          description: Epoch when the update takes effect
          nullable: true
        block_time:
          type: integer
          format: int32
          description: UNIX timestamp of the block containing the transaction
          nullable: true
        fixed_cost:
          $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
        owners:
          type: array
          items:
            type: string
          description: List of stake keys which control the pool
          nullable: true
        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
          nullable: true
        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
        tx_hash:
          type: string
          description: Transaction hash for the transaction which contained the update
        vrf_key_hash:
          type: string
          description: VRF key hash
          nullable: true
    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

````