{
  "opencollection": "1.0.0",
  "info": {
    "name": "Blockfrost.io ~ API Documentation Cardano » Accounts Cardano » Governance API",
    "version": "0.1.89"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "project_id",
      "value": "{{project_id}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "Cardano » Governance",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Constitutional committee",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/committee"
          },
          "docs": "Information about the currently active constitutional committee\n\nWhen `is_dissolved` is `true`, the committee has been removed by an enacted `NoConfidence` governance action; `quorum` and `members` still describe the last seated committee for historical reference.\n"
        },
        {
          "info": {
            "name": "Constitutional committee votes",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/committee/votes",
            "params": [
              {
                "name": "count",
                "value": "",
                "type": "query",
                "description": "The number of results displayed on one page."
              },
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "The page number for listing the results."
              },
              {
                "name": "order",
                "value": "",
                "type": "query",
                "description": "The ordering of items from the point of view of the blockchain,\nnot the page listing itself. By default, we return oldest first, newest last.\n"
              }
            ]
          },
          "docs": "History of all votes cast by constitutional committee members across all committees (current and past). Not scoped to the currently active committee."
        },
        {
          "info": {
            "name": "Constitutional committee member votes",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/committee/:cc_id/votes",
            "params": [
              {
                "name": "cc_id",
                "value": "cc_hot1qf4xq9mlra5j68w8zjz2lvf3kc3rtsdtu98ka7zx4u6jvqyy39ww0",
                "type": "path",
                "description": "CIP-129 bech32 committee credential (`cc_hot1...` or `cc_cold1...`)."
              },
              {
                "name": "count",
                "value": "",
                "type": "query",
                "description": "The number of results displayed on one page."
              },
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "The page number for listing the results."
              },
              {
                "name": "order",
                "value": "",
                "type": "query",
                "description": "The ordering of items from the point of view of the blockchain,\nnot the page listing itself. By default, we return oldest first, newest last.\n"
              }
            ]
          },
          "docs": "Votes cast under a given constitutional committee credential. Accepts both the CIP-129 hot bech32 (`cc_hot1...`) and the cold bech32 (`cc_cold1...`).\nWhen queried by a cold credential, this returns votes cast by any hot key that the cold key has authorized over time (so the result aggregates across hot-key rotations)."
        },
        {
          "info": {
            "name": "Delegate Representatives (DReps)",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/dreps",
            "params": [
              {
                "name": "count",
                "value": "",
                "type": "query",
                "description": "The number of results displayed on one page."
              },
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "The page number for listing the results."
              },
              {
                "name": "order",
                "value": "",
                "type": "query",
                "description": "The ordering of items. Direction applied to whichever sort key is selected by `order_by`.\nBy default, when sorting by registration order, we return oldest first, newest last.\n"
              },
              {
                "name": "order_by",
                "value": "",
                "type": "query",
                "description": "Optional sort key. When omitted, DReps are ordered by their internal registration order\n(the current default). Set to `amount` to sort by voting power.\n"
              },
              {
                "name": "retired",
                "value": "",
                "type": "query",
                "description": "Optional filter. When `true`, only returns DReps that have been deregistered.\nWhen `false`, only returns DReps that are currently registered.\nWhen omitted, both are returned.\n"
              },
              {
                "name": "expired",
                "value": "",
                "type": "query",
                "description": "Optional filter. When `true`, only returns DReps that have been inactive for longer than\nthe `drep_activity` protocol parameter. When `false`, only returns DReps that are not\nexpired. When omitted, both are returned.\n"
              }
            ]
          },
          "docs": "Return the information about Delegate Representatives (DReps)"
        },
        {
          "info": {
            "name": "Specific DRep",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/dreps/:drep_id",
            "params": [
              {
                "name": "drep_id",
                "value": "drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc",
                "type": "path",
                "description": "Bech32 or hexadecimal DRep ID."
              }
            ]
          },
          "docs": "DRep information."
        },
        {
          "info": {
            "name": "DRep delegators",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/dreps/:drep_id/delegators",
            "params": [
              {
                "name": "drep_id",
                "value": "drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn",
                "type": "path",
                "description": "Bech32 or hexadecimal drep ID."
              },
              {
                "name": "count",
                "value": "",
                "type": "query",
                "description": "The number of results displayed on one page."
              },
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "The page number for listing the results."
              },
              {
                "name": "order",
                "value": "",
                "type": "query",
                "description": "The ordering of items from the point of view of the blockchain,\nnot the page listing itself. By default, we return oldest first, newest last.\n"
              }
            ]
          },
          "docs": "List of Drep delegators."
        },
        {
          "info": {
            "name": "DRep metadata",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/dreps/:drep_id/metadata",
            "params": [
              {
                "name": "drep_id",
                "value": "drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc",
                "type": "path",
                "description": "Bech32 or hexadecimal DRep ID."
              }
            ]
          },
          "docs": "DRep metadata information."
        },
        {
          "info": {
            "name": "DRep updates",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/dreps/:drep_id/updates",
            "params": [
              {
                "name": "drep_id",
                "value": "drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc",
                "type": "path",
                "description": "Bech32 or hexadecimal DRep ID."
              },
              {
                "name": "count",
                "value": "",
                "type": "query",
                "description": "The number of results displayed on one page."
              },
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "The page number for listing the results."
              },
              {
                "name": "order",
                "value": "",
                "type": "query",
                "description": "The ordering of items from the point of view of the blockchain,\nnot the page listing itself. By default, we return oldest first, newest last.\n"
              }
            ]
          },
          "docs": "List of certificate updates to the DRep."
        },
        {
          "info": {
            "name": "DRep votes",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/dreps/:drep_id/votes",
            "params": [
              {
                "name": "drep_id",
                "value": "drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn",
                "type": "path",
                "description": "Bech32 or hexadecimal drep ID."
              },
              {
                "name": "count",
                "value": "",
                "type": "query",
                "description": "The number of results displayed on one page."
              },
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "The page number for listing the results."
              },
              {
                "name": "order",
                "value": "",
                "type": "query",
                "description": "The ordering of items from the point of view of the blockchain,\nnot the page listing itself. By default, we return oldest first, newest last.\n"
              }
            ]
          },
          "docs": "History of Drep votes."
        },
        {
          "info": {
            "name": "Proposals",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/proposals",
            "params": [
              {
                "name": "count",
                "value": "",
                "type": "query",
                "description": "The number of results displayed on one page."
              },
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "The page number for listing the results."
              },
              {
                "name": "order",
                "value": "",
                "type": "query",
                "description": "The ordering of items from the point of view of the blockchain,\nnot the page listing itself. By default, we return oldest first, newest last.\nOrdering in this case is based on the time of the first mint transaction.\n"
              }
            ]
          },
          "docs": "Return the information about Proposals"
        },
        {
          "info": {
            "name": "Specific proposal",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/proposals/:tx_hash/:cert_index",
            "params": [
              {
                "name": "tx_hash",
                "value": "2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531",
                "type": "path",
                "description": "Transaction hash."
              },
              {
                "name": "cert_index",
                "value": "1",
                "type": "path",
                "description": "Index of the certificate within the proposal transaction."
              }
            ]
          },
          "docs": "Proposal information."
        },
        {
          "info": {
            "name": "Specific parameters proposal",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/proposals/:tx_hash/:cert_index/parameters",
            "params": [
              {
                "name": "tx_hash",
                "value": "2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531",
                "type": "path",
                "description": "Transaction hash."
              },
              {
                "name": "cert_index",
                "value": "1",
                "type": "path",
                "description": "Index of the certificate within the proposal transaction."
              }
            ]
          },
          "docs": "Parameters proposal details."
        },
        {
          "info": {
            "name": "Specific withdrawals proposal",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/proposals/:tx_hash/:cert_index/withdrawals",
            "params": [
              {
                "name": "tx_hash",
                "value": "2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531",
                "type": "path",
                "description": "Transaction hash."
              },
              {
                "name": "cert_index",
                "value": "1",
                "type": "path",
                "description": "Index of the certificate within the proposal transaction."
              },
              {
                "name": "count",
                "value": "",
                "type": "query",
                "description": "The number of results displayed on one page."
              },
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "The page number for listing the results."
              },
              {
                "name": "order",
                "value": "",
                "type": "query",
                "description": "The ordering of items from the point of view of the blockchain,\nnot the page listing itself. By default, we return oldest first, newest last.\n"
              }
            ]
          },
          "docs": "Withdrawal proposal details."
        },
        {
          "info": {
            "name": "Proposal votes",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/proposals/:tx_hash/:cert_index/votes",
            "params": [
              {
                "name": "tx_hash",
                "value": "2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531",
                "type": "path",
                "description": "Transaction hash."
              },
              {
                "name": "cert_index",
                "value": "1",
                "type": "path",
                "description": "Index of the certificate within the proposal transaction."
              },
              {
                "name": "count",
                "value": "",
                "type": "query",
                "description": "The number of results displayed on one page."
              },
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "The page number for listing the results."
              },
              {
                "name": "order",
                "value": "",
                "type": "query",
                "description": "The ordering of items from the point of view of the blockchain,\nnot the page listing itself. By default, we return oldest first, newest last.\n"
              }
            ]
          },
          "docs": "History of Proposal votes."
        },
        {
          "info": {
            "name": "Specific proposal metadata",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/proposals/:tx_hash/:cert_index/metadata",
            "params": [
              {
                "name": "tx_hash",
                "value": "2403339d2f344202fb3583353e11a693a82860e59e65939dcb0e2ac72336d631",
                "type": "path",
                "description": "Transaction hash of the proposal."
              },
              {
                "name": "cert_index",
                "value": "0",
                "type": "path",
                "description": "Index of the certificate within the proposal transaction."
              }
            ]
          },
          "docs": "Proposal metadata information.\n\nIf this endpoint returns `404` or empty metadata for a known proposal, the off-chain metadata could not be fetched (e.g. unreachable URL or hash mismatch). Use the [`/governance/proposals/{gov_action_id}/metadata`](#tag/cardano--governance/GET/governance/proposals/{gov_action_id}/metadata) variant instead — it always returns the anchor `url` and `hash` along with an `error` object describing the fetch failure, so you can retrieve the metadata manually if needed.\n"
        },
        {
          "info": {
            "name": "GovActionID proposal",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/proposals/:gov_action_id",
            "params": [
              {
                "name": "gov_action_id",
                "value": "gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn",
                "type": "path",
                "description": "Governance Action Identifier (CIP-0129)"
              }
            ]
          },
          "docs": "Proposal information."
        },
        {
          "info": {
            "name": "GovActionID Proposal parameters",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/proposals/:gov_action_id/parameters",
            "params": [
              {
                "name": "gov_action_id",
                "value": "gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn",
                "type": "path",
                "description": "Governance Action Identifier (CIP-0129)"
              }
            ]
          },
          "docs": "Parameters proposal details."
        },
        {
          "info": {
            "name": "GovActionID Proposal withdrawals",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/proposals/:gov_action_id/withdrawals",
            "params": [
              {
                "name": "gov_action_id",
                "value": "gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn",
                "type": "path",
                "description": "Governance Action Identifier (CIP-0129)"
              },
              {
                "name": "count",
                "value": "",
                "type": "query",
                "description": "The number of results displayed on one page."
              },
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "The page number for listing the results."
              },
              {
                "name": "order",
                "value": "",
                "type": "query",
                "description": "The ordering of items from the point of view of the blockchain,\nnot the page listing itself. By default, we return oldest first, newest last.\n"
              }
            ]
          },
          "docs": "Withdrawal proposal details."
        },
        {
          "info": {
            "name": "GovActionID Proposal votes",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/proposals/:gov_action_id/votes",
            "params": [
              {
                "name": "gov_action_id",
                "value": "gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn",
                "type": "path",
                "description": "Governance Action Identifier (CIP-0129)"
              },
              {
                "name": "count",
                "value": "",
                "type": "query",
                "description": "The number of results displayed on one page."
              },
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "The page number for listing the results."
              },
              {
                "name": "order",
                "value": "",
                "type": "query",
                "description": "The ordering of items from the point of view of the blockchain,\nnot the page listing itself. By default, we return oldest first, newest last.\n"
              }
            ]
          },
          "docs": "History of Proposal votes."
        },
        {
          "info": {
            "name": "GovActionID proposal metadata",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://cardano-mainnet.blockfrost.io/api/v0/governance/proposals/:gov_action_id/metadata",
            "params": [
              {
                "name": "gov_action_id",
                "value": "gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn",
                "type": "path",
                "description": "Governance Action Identifier (CIP-0129)"
              }
            ]
          },
          "docs": "Proposal metadata information."
        }
      ]
    }
  ],
  "bundled": true
}