Blockfrost · Schema

proposal

proposal schema from Blockfrost API

BlockchainCardanoCryptocurrencyDAppsNFTWeb3

Properties

Name Type Description
id string Governance Action Identifier (CIP-0129)
tx_hash string Hash of the proposal transaction.
cert_index integer Index of the certificate within the proposal transaction.
governance_type string Type of proposal.
governance_description object An object describing the content of this GovActionProposal in a readable way.
deposit string The deposit amount paid for this proposal.
return_address string Bech32 stake address of the reward address to receive the deposit when it is repaid.
ratified_epoch integer The epoch at which the proposal was ratified. Null if the proposal has not been ratified.
enacted_epoch integer The epoch at which the proposal was enacted. Null if the proposal has not been enacted.
dropped_epoch integer The epoch at which the proposal was dropped. A proposal is dropped if it expires or if any of its dependencies expire.
expired_epoch integer The epoch at which the proposal expired. Null if the proposal has not expired.
expiration integer The epoch at which this governance action will expire.
View JSON Schema on GitHub

JSON Schema

blockfrost-proposal-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/blockfrost/refs/heads/main/json-schema/blockfrost-proposal-schema.json",
  "title": "proposal",
  "description": "proposal schema from Blockfrost API",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Governance Action Identifier (CIP-0129)"
    },
    "tx_hash": {
      "type": "string",
      "description": "Hash of the proposal transaction."
    },
    "cert_index": {
      "type": "integer",
      "description": "Index of the certificate within the proposal transaction."
    },
    "governance_type": {
      "type": "string",
      "enum": [
        "hard_fork_initiation",
        "new_committee",
        "new_constitution",
        "info_action",
        "no_confidence",
        "parameter_change",
        "treasury_withdrawals"
      ],
      "description": "Type of proposal."
    },
    "governance_description": {
      "additionalProperties": true,
      "type": "object",
      "nullable": true,
      "description": "An object describing the content of this GovActionProposal in a readable way."
    },
    "deposit": {
      "type": "string",
      "description": "The deposit amount paid for this proposal."
    },
    "return_address": {
      "type": "string",
      "description": "Bech32 stake address of the reward address to receive the deposit when it is repaid."
    },
    "ratified_epoch": {
      "type": "integer",
      "nullable": true,
      "description": "The epoch at which the proposal was ratified. Null if the proposal has not been ratified."
    },
    "enacted_epoch": {
      "type": "integer",
      "nullable": true,
      "description": "The epoch at which the proposal was enacted. Null if the proposal has not been enacted."
    },
    "dropped_epoch": {
      "type": "integer",
      "nullable": true,
      "description": "The epoch at which the proposal was dropped. A proposal is dropped if it expires or if any of its dependencies expire."
    },
    "expired_epoch": {
      "type": "integer",
      "nullable": true,
      "description": "The epoch at which the proposal expired. Null if the proposal has not expired."
    },
    "expiration": {
      "type": "integer",
      "description": "The epoch at which this governance action will expire."
    }
  },
  "required": [
    "id",
    "tx_hash",
    "cert_index",
    "governance_type",
    "deposit",
    "return_address",
    "governance_description",
    "ratified_epoch",
    "enacted_epoch",
    "dropped_epoch",
    "expired_epoch",
    "expiration"
  ]
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/blockfrost-proposal"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.