> ## 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 relay node information for a specific Cardano stake pool including IP addresses and DNS names.

# Stake pool relays



## OpenAPI

````yaml cardano/blockchain-indexer-api/openapi.json get /pools/{pool_id}/relays
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}/relays:
    get:
      tags:
        - Pools
      summary: Stake pool relays
      description: Returns a list of relays declared on-chain by the specified stake pool
      operationId: pool_relays
      parameters:
        - name: pool_id
          in: path
          description: Pool ID in bech32 format
          required: true
          schema:
            type: string
      responses:
        '200':
          description: List of relays declared on-chain by the specified pool
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TimestampedPoolRelays'
              example:
                data:
                  - pool_id_bech32: pool10qrz84cvz95zg8saf43ruhs5ulczuuqm2d3jn6d8xkkkzgzfje7
                    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
                last_updated:
                  timestamp: '2022-10-10 20:25:28'
                  block_hash: >-
                    44d7fa145be596adba7e1a122cee3204bc1177c21598a3ef199925a13c042082
                  block_slot: 96405276
        '500':
          description: Internal server error
components:
  schemas:
    TimestampedPoolRelays:
      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/PoolRelays'
        last_updated:
          $ref: '#/components/schemas/LastUpdated'
    PoolRelays:
      type: array
      items:
        $ref: '#/components/schemas/PoolRelay'
      description: A list of stake pool relays declared on-chain
    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
    PoolRelay:
      type: object
      description: Relay declared by a stake pool
      required:
        - pool_id_bech32
        - relays
      properties:
        pool_id_bech32:
          type: string
          description: Bech32 encoded pool ID
        relays:
          type: array
          items:
            $ref: '#/components/schemas/Relay'
          description: Relays declared by the pool
    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

````