---
title: "Stake pool metadata"
method: GET
path: "/pools/{pool_id}/metadata"
tags: ["Cardano » Pools"]
---

# Stake pool metadata

`GET /pools/{pool_id}/metadata`

Stake pool registration metadata.

## Path parameters

- `pool_id` string, required

## Response `200`

Return the pool metadata content.

- union
  - PoolMetadata
    - `pool_id` string, required — Bech32 pool ID
    - `hex` string, required — Hexadecimal pool ID
    - `url` string, nullable, required — URL to the stake pool metadata
    - `hash` string, nullable, required — Hash of the metadata file
    - `error` object — Present when metadata could not be fetched or validated.
      - `code` 'HASH_MISMATCH' | 'CONNECTION_ERROR' | 'HTTP_RESPONSE_ERROR' | 'DECODE_ERROR' | 'SIZE_EXCEEDED' | 'UNKNOWN_ERROR', required — Stable machine-readable error code.
      - `message` string, required — Human-readable description of the error.
    - `ticker` string, nullable, required — Ticker of the stake pool
    - `name` string, nullable, required — Name of the stake pool
    - `description` string, nullable, required — Description of the stake pool
    - `homepage` string, nullable, required — Home page of the stake pool
  - EmptyObject

## Other responses

- `400` — Bad request
- `403` — Authentication secret is missing or invalid
- `404` — Component not found
- `418` — IP has been auto-banned for extensive sending of requests after usage limit has been reached
- `429` — Usage limit reached
- `500` — Internal Server Error

---

[API](https://skmtc.net/txpipe/apis/blockfrost-io-api-documentation.md) · [All operations](https://skmtc.net/txpipe/apis/blockfrost-io-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/txpipe/blockfrost-io-api-documentation/versions/4a2f67b16876/schema)