openapi: 3.0.3
info:
  version: 0.1.89
  title: Blockfrost.io ~ API Documentation Cardano » Accounts Cardano » Governance API
  x-logo:
    url: https://staging.blockfrost.io/images/logo.svg
    altText: Blockfrost
  contact:
    name: Blockfrost Team
    url: https://blockfrost.io
    email: contact@blockfrost.io
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  termsOfService: https://blockfrost.io/terms
  description: "Blockfrost is an API as a service that allows users to interact with the Cardano blockchain, Midnight blockchain, and parts of their ecosystems.\n\n## Tokens\n\nAfter signing up on https://blockfrost.io, a `project_id` token is automatically generated for each project.\nHTTP header of your request MUST include this `project_id` in order to authenticate against Blockfrost servers.\n\n## Available networks\n\nAt the moment, you can use the following networks. Please, note that each network has its own `project_id`.\n\n<table>\n  <tbody>\n    <tr>\n      <td>\n          <b>Network</b>\n      </td>\n      <td>\n          <b>Endpoint</b>\n      </td>\n    </tr>\n    <tr>\n        <td>Cardano mainnet</td>\n        <td>\n            <code>https://cardano-mainnet.blockfrost.io/api/v0</code>\n        </td>\n    </tr>\n    <tr>\n        <td>Cardano preprod</td>\n        <td>\n            <code>https://cardano-preprod.blockfrost.io/api/v0</code>\n        </td>\n    </tr>\n    <tr>\n        <td>Cardano preview</td>\n        <td>\n            <code>https://cardano-preview.blockfrost.io/api/v0</code>\n        </td>\n    </tr>\n    <tr>\n        <td>Midnight mainnet</td>\n        <td>\n            <code>https://midnight-mainnet.blockfrost.io/api/v0</code>\n        </td>\n    </tr>\n    <tr>\n        <td>InterPlanetary File System</td>\n        <td>\n            <code>https://ipfs.blockfrost.io/api/v0</code>\n        </td>\n    </tr>\n  </tbody>\n</table>\n\n## Concepts\n\n* All endpoints return either a JSON object or an array.\n* Data is returned in *ascending* (oldest first, newest last) order, if not stated otherwise.\n  * You might use the `?order=desc` query parameter to reverse this order.\n* By default, we return 100 results at a time. You have to use `?page=2` to list through the results.\n* All time and timestamp related fields (except `server_time`) are in seconds of UNIX time.\n* All amounts are returned in Lovelaces, where 1 ADA = 1 000 000 Lovelaces.\n* Addresses, accounts and pool IDs are in Bech32 format.\n* All values are case sensitive.\n* All hex encoded values are lower case.\n* Examples are not based on real data. Any resemblance to actual events is purely coincidental.\n* We allow to upload files up to 100MB of size to IPFS. This might increase in the future.\n* Only pinned IPFS files are counted towards the IPFS quota.\n* Non-pinned IPFS files are subject to regular garbage collection and will be removed unless pinned.\n* We allow maximum of 100 queued pins per IPFS user.\n\n## Errors\n\n### HTTP Status codes\n\nThe following are HTTP status code your application might receive when reaching Blockfrost endpoints and\nit should handle all of these cases.\n\n* HTTP `400` return code is used when the request is not valid.\n* HTTP `402` return code is used when the projects exceed their daily request limit.\n* HTTP `403` return code is used when the request is not authenticated.\n* HTTP `404` return code is used when the resource doesn't exist.\n* HTTP `418` return code is used when the user has been auto-banned for flooding too much after previously receiving error code `402` or `429`.\n* HTTP `425` return code is used in Cardano networks, when the user has submitted a transaction when the mempool is already full, not accepting new txs straight away.\n* HTTP `425` return code is used in IPFS network, when the user has submitted a pin when the pin queue is already full, not accepting new pins straight away.\n* HTTP `429` return code is used when the user has sent too many requests in a given amount of time and therefore has been rate-limited.\n* HTTP `500` return code is used when our endpoints are having a problem.\n\n### Error codes\n\nAn internal error code number is used for better indication of the error in question. It is passed using the following payload.\n\n```json\n{\n  \"status_code\": 403,\n  \"error\": \"Forbidden\",\n  \"message\": \"Invalid project token.\"\n}\n```\n## Limits\n\nThere are two types of limits we are enforcing:\n\nThe first depends on your plan and is the number of request we allow per day. We defined the day from midnight to midnight of UTC time.\n\nThe second is rate limiting. We limit an end user, distinguished by IP address, to 10 requests per second. On top of that, we allow\neach user to send burst of 500 requests, which cools off at rate of 10 requests per second. In essence, a user is allowed to make another\nwhole burst after (currently) 500/10 = 50 seconds. E.g. if a user attempts to make a call 3 seconds after whole burst, 30 requests will be processed.\nWe believe this should be sufficient for most of the use cases. If it is not and you have a specific use case, please get in touch with us, and\nwe will make sure to take it into account as much as we can.\n\n## SDKs\n\nWe support a number of SDKs that will help you in developing your application on top of Blockfrost.\n\n<table>\n  <tbody>\n    <tr>\n        <td><b>Programming language</b></td>\n        <td><b>SDK</b></td>\n    </tr>\n    <tr>\n        <td>JavaScript</td>\n        <td>\n            <a href=\"https://github.com/blockfrost/blockfrost-js\">blockfrost-js</a>\n        </td>\n    </tr>\n    <tr>\n        <td>Haskell</td>\n        <td>\n            <a href=\"https://github.com/blockfrost/blockfrost-haskell\">blockfrost-haskell</a>\n        </td>\n    </tr>\n    <tr>\n        <td>Python</td>\n        <td>\n            <a href=\"https://github.com/blockfrost/blockfrost-python\">blockfrost-python</a>\n        </td>\n    </tr>\n    <tr>\n        <td>Rust</td>\n        <td>\n            <a href=\"https://github.com/blockfrost/blockfrost-rust\">blockfrost-rust</a>\n        </td>\n    </tr>\n    <tr>\n        <td>Golang</td>\n        <td>\n            <a href=\"https://github.com/blockfrost/blockfrost-go\">blockfrost-go</a>\n        </td>\n    </tr>\n    <tr>\n        <td>Ruby</td>\n        <td>\n            <a href=\"https://github.com/blockfrost/blockfrost-ruby\">blockfrost-ruby</a>\n        </td>\n    </tr>\n    <tr>\n        <td>Java</td>\n        <td>\n            <a href=\"https://github.com/blockfrost/blockfrost-java\">blockfrost-java</a>\n        </td>\n    </tr>\n    <tr>\n        <td>Scala</td>\n        <td>\n            <a href=\"https://github.com/blockfrost/blockfrost-scala\">blockfrost-scala</a>\n        </td>\n    </tr>\n    <tr>\n        <td>Swift</td>\n        <td>\n            <a href=\"https://github.com/blockfrost/blockfrost-swift\">blockfrost-swift</a>\n        </td>\n    </tr>\n    <tr>\n        <td>Kotlin</td>\n        <td>\n            <a href=\"https://github.com/blockfrost/blockfrost-kotlin\">blockfrost-kotlin</a>\n        </td>\n    </tr>\n    <tr>\n        <td>Elixir</td>\n        <td>\n            <a href=\"https://github.com/blockfrost/blockfrost-elixir\">blockfrost-elixir</a>\n        </td>\n    </tr>\n    <tr>\n        <td>.NET</td>\n        <td>\n            <a href=\"https://github.com/blockfrost/blockfrost-dotnet\">blockfrost-dotnet</a>\n        </td>\n    </tr>\n    <tr>\n        <td>Arduino</td>\n        <td>\n            <a href=\"https://github.com/blockfrost/blockfrost-arduino\">blockfrost-arduino</a>\n        </td>\n    </tr>\n    <tr>\n        <td>PHP</td>\n        <td>\n            <a href=\"https://github.com/blockfrost/blockfrost-php\">blockfrost-php</a>\n        </td>\n    </tr>\n    <tr>\n        <td>Crystal</td>\n        <td>\n            <a href=\"https://github.com/blockfrost/blockfrost-crystal\">blockfrost-crystal</a>\n        </td>\n    </tr>\n  </tbody>\n</table>\n\n\n## Midnight API\n\n\nThe Midnight Indexer API exposes a GraphQL API that enables clients to query and subscribe to blockchain data — blocks, transactions, contracts, and wallet-related events — indexed from the Midnight blockchain.\n\nAvailable networks: `mainnet`, `preprod`, `preview`\n\n| Service | URL | Protocol |\n|---------|-----|----------|\n| **Indexer HTTP API** | `https://midnight-{network}.blockfrost.io/api/v0` | HTTP POST (GraphQL) |\n| **Indexer Subscriptions API** | `wss://midnight-{network}.blockfrost.io/api/v0/ws` | WebSocket |\n| **Node RPC** | `https://rpc.midnight-{network}.blockfrost.io` | JSON-RPC |\n\n\nFor the full documentation — queries, mutations, subscriptions, authentication options, and examples — see the Midnight GraphQL API Reference:\n\n[![Explore the Midnight API →](https://img.shields.io/badge/Explore_the_Midnight_API_→-0033AD?style=for-the-badge)](./midnight/)\n"
servers:
- url: https://cardano-mainnet.blockfrost.io/api/v0
  description: Cardano Mainnet network
- url: https://cardano-preprod.blockfrost.io/api/v0
  description: Cardano Preprod network
- url: https://cardano-preview.blockfrost.io/api/v0
  description: Cardano Preview network
- url: https://localhost:3000
  description: local
security:
- project_id: []
tags:
- name: Cardano » Governance
paths:
  /governance/committee:
    get:
      tags:
      - Cardano » Governance
      summary: Constitutional committee
      description: 'Information about the currently active constitutional committee


        When `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.

        '
      responses:
        '200':
          description: Return the active constitutional committee
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/committee'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
  /governance/committee/votes:
    get:
      tags:
      - Cardano » Governance
      summary: Constitutional committee votes
      description: History of all votes cast by constitutional committee members across all committees (current and past). Not scoped to the currently active committee.
      parameters:
      - in: query
        name: count
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 100
        description: The number of results displayed on one page.
      - in: query
        name: page
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 21474836
          default: 1
        description: The page number for listing the results.
      - in: query
        name: order
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          default: asc
        description: 'The ordering of items from the point of view of the blockchain,

          not the page listing itself. By default, we return oldest first, newest last.

          '
      responses:
        '200':
          description: Return constitutional committee votes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/committee_votes'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
  /governance/committee/{cc_id}/votes:
    get:
      tags:
      - Cardano » Governance
      summary: Constitutional committee member votes
      description: 'Votes cast under a given constitutional committee credential. Accepts both the CIP-129 hot bech32 (`cc_hot1...`) and the cold bech32 (`cc_cold1...`).

        When 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).'
      parameters:
      - in: path
        name: cc_id
        required: true
        schema:
          type: string
        description: CIP-129 bech32 committee credential (`cc_hot1...` or `cc_cold1...`).
        example: cc_hot1qf4xq9mlra5j68w8zjz2lvf3kc3rtsdtu98ka7zx4u6jvqyy39ww0
      - in: query
        name: count
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 100
        description: The number of results displayed on one page.
      - in: query
        name: page
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 21474836
          default: 1
        description: The page number for listing the results.
      - in: query
        name: order
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          default: asc
        description: 'The ordering of items from the point of view of the blockchain,

          not the page listing itself. By default, we return oldest first, newest last.

          '
      responses:
        '200':
          description: Return votes for the given committee credential
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/committee_votes'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
  /governance/dreps:
    get:
      tags:
      - Cardano » Governance
      summary: Delegate Representatives (DReps)
      description: Return the information about Delegate Representatives (DReps)
      parameters:
      - in: query
        name: count
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 100
        description: The number of results displayed on one page.
      - in: query
        name: page
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 21474836
          default: 1
        description: The page number for listing the results.
      - in: query
        name: order
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          default: asc
        description: 'The ordering of items. Direction applied to whichever sort key is selected by `order_by`.

          By default, when sorting by registration order, we return oldest first, newest last.

          '
      - in: query
        name: order_by
        required: false
        schema:
          type: string
          enum:
          - amount
        description: 'Optional sort key. When omitted, DReps are ordered by their internal registration order

          (the current default). Set to `amount` to sort by voting power.

          '
      - in: query
        name: retired
        required: false
        schema:
          type: boolean
        description: 'Optional filter. When `true`, only returns DReps that have been deregistered.

          When `false`, only returns DReps that are currently registered.

          When omitted, both are returned.

          '
      - in: query
        name: expired
        required: false
        schema:
          type: boolean
        description: 'Optional filter. When `true`, only returns DReps that have been inactive for longer than

          the `drep_activity` protocol parameter. When `false`, only returns DReps that are not

          expired. When omitted, both are returned.

          '
      responses:
        '200':
          description: Paginated array with the Delegate Representatives (DReps) data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dreps'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
  /governance/dreps/{drep_id}:
    get:
      tags:
      - Cardano » Governance
      summary: Specific DRep
      description: DRep information.
      parameters:
      - in: path
        name: drep_id
        required: true
        schema:
          type: string
        description: Bech32 or hexadecimal DRep ID.
        example: drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc
      responses:
        '200':
          description: Return the DRep information content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/drep'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
  /governance/dreps/{drep_id}/delegators:
    get:
      tags:
      - Cardano » Governance
      summary: DRep delegators
      description: List of Drep delegators.
      parameters:
      - in: path
        name: drep_id
        required: true
        schema:
          type: string
        description: Bech32 or hexadecimal drep ID.
        example: drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn
      - in: query
        name: count
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 100
        description: The number of results displayed on one page.
      - in: query
        name: page
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 21474836
          default: 1
        description: The page number for listing the results.
      - in: query
        name: order
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          default: asc
        description: 'The ordering of items from the point of view of the blockchain,

          not the page listing itself. By default, we return oldest first, newest last.

          '
      responses:
        '200':
          description: Return the DRep delegations
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/drep_delegators'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
  /governance/dreps/{drep_id}/metadata:
    get:
      tags:
      - Cardano » Governance
      summary: DRep metadata
      description: DRep metadata information.
      parameters:
      - in: path
        name: drep_id
        required: true
        schema:
          type: string
        description: Bech32 or hexadecimal DRep ID.
        example: drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc
      responses:
        '200':
          description: Return the DRep metadata content.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/drep_metadata'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
  /governance/dreps/{drep_id}/updates:
    get:
      tags:
      - Cardano » Governance
      summary: DRep updates
      description: List of certificate updates to the DRep.
      parameters:
      - in: path
        name: drep_id
        required: true
        schema:
          type: string
        description: Bech32 or hexadecimal DRep ID.
        example: drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc
      - in: query
        name: count
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 100
        description: The number of results displayed on one page.
      - in: query
        name: page
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 21474836
          default: 1
        description: The page number for listing the results.
      - in: query
        name: order
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          default: asc
        description: 'The ordering of items from the point of view of the blockchain,

          not the page listing itself. By default, we return oldest first, newest last.

          '
      responses:
        '200':
          description: Return the Drep updates history
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/drep_updates'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
  /governance/dreps/{drep_id}/votes:
    get:
      tags:
      - Cardano » Governance
      summary: DRep votes
      description: History of Drep votes.
      parameters:
      - in: path
        name: drep_id
        required: true
        schema:
          type: string
        description: Bech32 or hexadecimal drep ID.
        example: drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn
      - in: query
        name: count
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 100
        description: The number of results displayed on one page.
      - in: query
        name: page
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 21474836
          default: 1
        description: The page number for listing the results.
      - in: query
        name: order
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          default: asc
        description: 'The ordering of items from the point of view of the blockchain,

          not the page listing itself. By default, we return oldest first, newest last.

          '
      responses:
        '200':
          description: Return the DRep votes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/drep_votes'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
  /governance/proposals:
    get:
      tags:
      - Cardano » Governance
      summary: Proposals
      description: Return the information about Proposals
      parameters:
      - in: query
        name: count
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 100
        description: The number of results displayed on one page.
      - in: query
        name: page
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 21474836
          default: 1
        description: The page number for listing the results.
      - in: query
        name: order
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          default: asc
        description: 'The ordering of items from the point of view of the blockchain,

          not the page listing itself. By default, we return oldest first, newest last.

          Ordering in this case is based on the time of the first mint transaction.

          '
      responses:
        '200':
          description: Paginated array with the proposal data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/proposals'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
  /governance/proposals/{tx_hash}/{cert_index}:
    get:
      tags:
      - Cardano » Governance
      summary: Specific proposal
      description: Proposal information.
      parameters:
      - in: path
        name: tx_hash
        required: true
        schema:
          type: string
        description: Transaction hash.
        example: 2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531
      - in: path
        name: cert_index
        required: true
        schema:
          type: integer
        description: Index of the certificate within the proposal transaction.
        example: 1
      responses:
        '200':
          description: Return the proposal information content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/proposal'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
  /governance/proposals/{tx_hash}/{cert_index}/parameters:
    get:
      tags:
      - Cardano » Governance
      summary: Specific parameters proposal
      description: Parameters proposal details.
      parameters:
      - in: path
        name: tx_hash
        required: true
        schema:
          type: string
        description: Transaction hash.
        example: 2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531
      - in: path
        name: cert_index
        required: true
        schema:
          type: integer
        description: Index of the certificate within the proposal transaction.
        example: 1
      responses:
        '200':
          description: Return the proposal parameters content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/proposal_parameters'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
  /governance/proposals/{tx_hash}/{cert_index}/withdrawals:
    get:
      tags:
      - Cardano » Governance
      summary: Specific withdrawals proposal
      description: Withdrawal proposal details.
      parameters:
      - in: path
        name: tx_hash
        required: true
        schema:
          type: string
        description: Transaction hash.
        example: 2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531
      - in: path
        name: cert_index
        required: true
        schema:
          type: integer
        description: Index of the certificate within the proposal transaction.
        example: 1
      - in: query
        name: count
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 100
        description: The number of results displayed on one page.
      - in: query
        name: page
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 21474836
          default: 1
        description: The page number for listing the results.
      - in: query
        name: order
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          default: asc
        description: 'The ordering of items from the point of view of the blockchain,

          not the page listing itself. By default, we return oldest first, newest last.

          '
      responses:
        '200':
          description: Return the proposal withdrawals content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/proposal_withdrawals'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
  /governance/proposals/{tx_hash}/{cert_index}/votes:
    get:
      tags:
      - Cardano » Governance
      summary: Proposal votes
      description: History of Proposal votes.
      parameters:
      - in: path
        name: tx_hash
        required: true
        schema:
          type: string
        description: Transaction hash.
        example: 2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531
      - in: path
        name: cert_index
        required: true
        schema:
          type: integer
        description: Index of the certificate within the proposal transaction.
        example: 1
      - in: query
        name: count
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 100
        description: The number of results displayed on one page.
      - in: query
        name: page
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 21474836
          default: 1
        description: The page number for listing the results.
      - in: query
        name: order
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          default: asc
        description: 'The ordering of items from the point of view of the blockchain,

          not the page listing itself. By default, we return oldest first, newest last.

          '
      responses:
        '200':
          description: Return the Proposal votes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/proposal_votes'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
  /governance/proposals/{tx_hash}/{cert_index}/metadata:
    get:
      tags:
      - Cardano » Governance
      summary: Specific proposal metadata
      description: 'Proposal metadata information.


        If 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.

        '
      parameters:
      - in: path
        name: tx_hash
        required: true
        schema:
          type: string
        description: Transaction hash of the proposal.
        example: 2403339d2f344202fb3583353e11a693a82860e59e65939dcb0e2ac72336d631
      - in: path
        name: cert_index
        required: true
        schema:
          type: integer
        description: Index of the certificate within the proposal transaction.
        example: 0
      responses:
        '200':
          description: Return the proposal information content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/proposal_metadata'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
  /governance/proposals/{gov_action_id}:
    get:
      tags:
      - Cardano » Governance
      summary: GovActionID proposal
      description: Proposal information.
      parameters:
      - in: path
        name: gov_action_id
        required: true
        schema:
          type: string
        description: Governance Action Identifier (CIP-0129)
        example: gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn
      responses:
        '200':
          description: Return the proposal information content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/proposal'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
  /governance/proposals/{gov_action_id}/parameters:
    get:
      tags:
      - Cardano » Governance
      summary: GovActionID Proposal parameters
      description: Parameters proposal details.
      parameters:
      - in: path
        name: gov_action_id
        required: true
        schema:
          type: string
        description: Governance Action Identifier (CIP-0129)
        example: gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn
      responses:
        '200':
          description: Return the proposal parameters content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/proposal_parameters'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
  /governance/proposals/{gov_action_id}/withdrawals:
    get:
      tags:
      - Cardano » Governance
      summary: GovActionID Proposal withdrawals
      description: Withdrawal proposal details.
      parameters:
      - in: path
        name: gov_action_id
        required: true
        schema:
          type: string
        description: Governance Action Identifier (CIP-0129)
        example: gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn
      - in: query
        name: count
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 100
        description: The number of results displayed on one page.
      - in: query
        name: page
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 21474836
          default: 1
        description: The page number for listing the results.
      - in: query
        name: order
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          default: asc
        description: 'The ordering of items from the point of view of the blockchain,

          not the page listing itself. By default, we return oldest first, newest last.

          '
      responses:
        '200':
          description: Return the proposal withdrawals content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/proposal_withdrawals'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
  /governance/proposals/{gov_action_id}/votes:
    get:
      tags:
      - Cardano » Governance
      summary: GovActionID Proposal votes
      description: History of Proposal votes.
      parameters:
      - in: path
        name: gov_action_id
        required: true
        schema:
          type: string
        description: Governance Action Identifier (CIP-0129)
        example: gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn
      - in: query
        name: count
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 100
        description: The number of results displayed on one page.
      - in: query
        name: page
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 21474836
          default: 1
        description: The page number for listing the results.
      - in: query
        name: order
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          default: asc
        description: 'The ordering of items from the point of view of the blockchain,

          not the page listing itself. By default, we return oldest first, newest last.

          '
      responses:
        '200':
          description: Return the Proposal votes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/proposal_votes'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
  /governance/proposals/{gov_action_id}/metadata:
    get:
      tags:
      - Cardano » Governance
      summary: GovActionID proposal metadata
      description: Proposal metadata information.
      parameters:
      - in: path
        name: gov_action_id
        required: true
        schema:
          type: string
        description: Governance Action Identifier (CIP-0129)
        example: gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn
      responses:
        '200':
          description: Return the proposal information content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/proposal_metadata_v2'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '418':
          $ref: '#/components/responses/418'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
components:
  schemas:
    committee_votes:
      type: array
      items:
        type: object
        properties:
          tx_hash:
            type: string
            description: Hash of the vote transaction.
          voter_hot_id:
            type: string
            description: CIP-129 bech32 encoded hot credential of the committee member that cast this vote (`cc_hot1...`).
          proposal_id:
            type: string
            description: CIP-129 Governance Action Identifier of the proposal being voted on.
          proposal_tx_hash:
            type: string
            description: Hash of the proposal transaction.
          proposal_index:
            type: integer
            description: Index of the proposal within its transaction.
          governance_type:
            type: string
            enum:
            - hard_fork_initiation
            - new_committee
            - new_constitution
            - info_action
            - no_confidence
            - parameter_change
            - treasury_withdrawals
            description: Type of the governance action being voted on.
          vote:
            type: string
            enum:
            - 'yes'
            - 'no'
            - abstain
            description: The Vote. Can be one of yes, no, abstain.
          metadata_url:
            type: string
            nullable: true
            description: Voting anchor URL — pointer to the off-chain rationale published by the voter.
          metadata_hash:
            type: string
            nullable: true
            description: Hex hash of the off-chain anchor document.
          block_height:
            type: integer
            description: Block height of the vote transaction.
          block_time:
            type: integer
            description: Block creation time in UNIX time of the vote transaction.
        required:
        - tx_hash
        - voter_hot_id
        - proposal_id
        - proposal_tx_hash
        - proposal_index
        - governance_type
        - vote
        - metadata_url
        - metadata_hash
        - block_height
        - block_time
      example:
      - tx_hash: b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5
        voter_hot_id: cc_hot1qf4xq9mlra5j68w8zjz2lvf3kc3rtsdtu98ka7zx4u6jvqyy39ww0
        proposal_id: gov_action1k2jertppnnndejjcglszfqq4yzw8evzrd2nt66rr6rqlz54xp0zsq05ecsn
        proposal_tx_hash: b2a591ac219ce6dcca5847e0248015209c7cb0436aa6bd6863d0c1f152a60bc5
        proposal_index: 0
        governance_type: parameter_change
        vote: 'yes'
        metadata_url: https://my.cc-member/rationale.jsonld
        metadata_hash: a4b7d5d34f5d8c5b71a0a5c34b7e7f8a3d2e1c0b9a8f7e6d5c4b3a2918f7e6d5
        block_height: 11045358
        block_time: 1746037200
      - tx_hash: 8a91b32ec2a7bdfde2ab7a1bc5e4d3a2f1b0c9d8e7f6a5b4c3d2e1f0a9b8c7d6
        voter_hot_id: cc_hot1qf4xq9mlra5j68w8zjz2lvf3kc3rtsdtu98ka7zx4u6jvqyy39ww0
        proposal_id: gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn
        proposal_tx_hash: 2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531
        proposal_index: 1
        governance_type: new_constitution
        vote: abstain
        metadata_url: null
        metadata_hash: null
        block_height: 11045890
        block_time: 1746070800
    proposal_withdrawals:
      type: array
      items:
        type: object
        properties:
          stake_address:
            type: string
            example: stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7
            description: Bech32 stake address
          amount:
            type: string
            description: Withdrawal amount in Lovelaces
        required:
        - stake_address
        - amount
      example:
      - stake_address: stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7
        amount: '454541212442'
      - stake_address: stake1xx2g2c9dx2nhhehyrezyxpkstoppcqmu9hk63qgfkccw5rqttygt2
        amount: '97846969'
    drep:
      type: object
      properties:
        drep_id:
          type: string
          description: Bech32 encoded DRep address
        hex:
          type: string
          description: The raw bytes of the DRep
        amount:
          type: string
          description: The total amount of voting power this DRep is delegated.
        active:
          type: boolean
          description: Registration state of the DRep
          deprecated: true
        active_epoch:
          type: integer
          nullable: true
          description: Epoch of the most recent registration
          deprecated: true
        has_script:
          type: boolean
          description: Flag indicating whether this DRep's credential is a script hash
        retired:
          type: boolean
          description: Registration state of the DRep. Set to `true` if the DRep has been deregistered; otherwise, `false`.
        expired:
          type: boolean
          description: Whether the DRep has been inactive for a consecutive number of epochs (determined by an epoch parameter `drep_activity`)
        last_active_epoch:
          type: integer
          nullable: true
          description: Epoch of the most recent action - registration, update, deregistration or voting
      required:
      - drep_id
      - hex
      - amount
      - active
      - active_epoch
      - has_script
      - retired
      - expired
      - last_active_epoch
      example:
        drep_id: drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc
        hex: a61261172624e8333ceff098648d90f8e404e2e36d5b5f5985cbd35d
        amount: '2000000'
        active: true
        active_epoch: 420
        has_script: true
        last_active_epoch: 509
        retired: false
        expired: false
    proposal:
      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
      example:
        id: gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn
        tx_hash: 2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531
        cert_index: 1
        governance_type: treasury_withdrawals
        deposit: '12000'
        return_address: stake_test1urd3hs7rlxwwdzthe6hj026dmyt3y0heuulctscyydh2kgck6nkmz
        governance_description:
          tag: InfoAction
        ratified_epoch: null
        enacted_epoch: 123
        dropped_epoch: null
        expired_epoch: null
        expiration: 120
    drep_metadata:
      type: object
      properties:
        drep_id:
          type: string
          description: Bech32 encoded addresses
        hex:
          type: string
          description: The raw bytes of the DRep
        url:
          type: string
          example: https://stakenuts.com/drep.json
          description: URL to the drep metadata
        hash:
          type: string
          example: 69c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c"
          description: Hash of the metadata file
        json_metadata:
          anyOf:
          - type: string
          - type: object
            additionalProperties: true
          - type: array
            items: {}
          - type: integer
          - type: number
          - type: boolean
          - type: 'null'
          description: Content of the JSON metadata (validated CIP-119)
        bytes:
          type: string
          description: Content of the metadata (raw)
          nullable: true
        error:
          type: object
          description: Present when metadata could not be fetched or validated.
          properties:
            code:
              type: string
              description: Stable machine-readable error code.
              enum:
              - HASH_MISMATCH
              - CONNECTION_ERROR
              - HTTP_RESPONSE_ERROR
              - DECODE_ERROR
              - SIZE_EXCEEDED
              - UNKNOWN_ERROR
            message:
              type: string
              description: Human-readable description of the error.
          required:
          - code
          - message
      required:
      - drep_id
      - hex
      - url
      - hash
      - json_metadata
      - bytes
      example:
        drep_id: drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc
        hex: a61261172624e8333ceff098648d90f8e404e2e36d5b5f5985cbd35d
        url: https://aaa.xyz/drep.json
        hash: a14a5ad4f36bddc00f92ddb39fd9ac633c0fd43f8bfa57758f9163d10ef916de
        json_metadata:
          '@context':
            CIP100: https://github.com/cardano-foundation/CIPs/blob/master/CIP-0100/README.md#
            CIP119: https://github.com/cardano-foundation/CIPs/blob/master/CIP-0119/README.md#
            hashAlgorithm: CIP100:hashAlgorithm
            body:
              '@id': CIP119:body
              '@context':
                references:
                  '@id': CIP119:references
                  '@container': '@set'
                  '@context':
                    GovernanceMetadata: CIP100:GovernanceMetadataReference
                    Other: CIP100:OtherReference
                    label: CIP100:reference-label
                    uri: CIP100:reference-uri
                paymentAddress: CIP119:paymentAddress
                givenName: CIP119:givenName
                image:
                  '@id': CIP119:image
                  '@context':
                    ImageObject: https://schema.org/ImageObject
                objectives: CIP119:objectives
                motivations: CIP119:motivations
                qualifications: CIP119:qualifications
          hashAlgorithm: blake2b-256
          body:
            paymentAddress: addr1q86dnpkva4mm859c8ur7tjxn57zgsu6vg8pdetkdve3fsacnq7twy06u2ev5759vutpjgzfryx0ud8hzedhzerava35qwh3x34
            givenName: Ryan Williams
            image:
              '@type': ImageObject
              contentUrl: https://avatars.githubusercontent.com/u/44342099?v=4
              sha256: 2a21e4f7b20c8c72f573707b068fb8fc6d8c64d5035c4e18ecae287947fe2b2e
            objectives: Buy myself an island.
            motivations: I really would like to own an island.
            qualifications: I have my 100m swimming badge, so I would be qualified to be able to swim around island.
            references:
            - '@type': Other
              label: A cool island for Ryan
              uri: https://www.google.com/maps/place/World's+only+5th+order+recursive+island/@62.6511465,-97.7946829,15.75z/data=!4m14!1m7!3m6!1s0x5216a167810cee39:0x11431abdfe4c7421!2sWorld's+only+5th+order+recursive+island!8m2!3d62.651114!4d-97.7872244!16s%2Fg%2F11spwk2b6n!3m5!1s0x5216a167810cee39:0x11431abdfe4c7421!8m2!3d62.651114!4d-97.7872244!16s%2Fg%2F11spwk2b6n?authuser=0&entry=ttu
            - '@type': Link
              label: Ryan's Twitter
              uri: https://twitter.com/Ryun1_
        bytes: \x7b0a20202240636f6e74657874223a207b0a2020202022406c616e6775616765223a2022656e2d7573222c0a2020202022434950313030223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130302f524541444d452e6
    proposals:
      type: array
      items:
        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.
        required:
        - id
        - tx_hash
        - cert_index
        - governance_type
      example:
      - id: gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn
        tx_hash: 2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531
        cert_index: 1
        governance_type: treasury_withdrawals
      - id: gov_action1zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3
        tx_hash: 71317e951b20aa46e9fbf45a46a6e950d5723a481225519655bf6c60
        cert_index: 4
        governance_type: no_confidence
    drep_updates:
      type: array
      items:
        type: object
        properties:
          tx_hash:
            type: string
            description: Transaction ID
          cert_index:
            type: integer
            description: Index of the certificate within the update transaction.
          action:
            type: string
            enum:
            - registered
            - deregistered
            - updated
            description: Action in the certificate
          deposit:
            type: string
            nullable: true
            description: Deposit in Lovelaces paid at this registration. `null` on `deregistered` and `updated` rows.
        required:
        - tx_hash
        - cert_index
        - action
        - deposit
      example:
      - tx_hash: f4097fbdb87ab7c7ab44b30d4e2b81713a058488975d1ab8b05c381dd946a393
        cert_index: 0
        action: registered
        deposit: '500000000'
      - tx_hash: dd3243af975be4b5bedce4e5f5b483b2386d5ad207d05e0289c1df0eb261447e
        cert_index: 0
        action: deregistered
        deposit: null
    dreps:
      type: array
      items:
        type: object
        properties:
          drep_id:
            type: string
            description: The Bech32 encoded DRep address
          hex:
            type: string
            description: The raw bytes of the DRep
          amount:
            type: string
            description: The total amount of voting power this DRep is delegated.
          has_script:
            type: boolean
            description: Flag indicating whether this DRep's credential is a script hash
          retired:
            type: boolean
            description: Registration state of the DRep. Set to `true` if the DRep has been deregistered; otherwise, `false`.
          expired:
            type: boolean
            description: Whether the DRep has been inactive for a consecutive number of epochs (determined by an epoch parameter `drep_activity`)
          last_active_epoch:
            type: integer
            nullable: true
            description: Epoch of the most recent action - registration, update, deregistration or voting
          metadata:
            type: object
            nullable: true
            description: 'Off-chain metadata associated with the DRep''s latest registration.

              `null` when the DRep has no registration anchor (e.g. special DReps such as

              `drep_always_abstain` / `drep_always_no_confidence`). When an anchor exists but

              the off-chain content could not be fetched or validated, `error` is populated and

              `json_metadata` / `bytes` are `null`.

              '
            properties:
              url:
                type: string
                example: https://stakenuts.com/drep.json
                description: URL to the drep metadata
              hash:
                type: string
                example: 69c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c
                description: Hash of the metadata file
              json_metadata:
                anyOf:
                - type: string
                - type: object
                  additionalProperties: true
                - type: array
                  items: {}
                - type: integer
                - type: number
                - type: boolean
                - type: 'null'
                description: Content of the JSON metadata (validated CIP-119)
              bytes:
                type: string
                description: Content of the metadata (raw)
                nullable: true
              error:
                type: object
                description: Present when metadata could not be fetched or validated.
                properties:
                  code:
                    type: string
                    description: Stable machine-readable error code.
                    enum:
                    - HASH_MISMATCH
                    - CONNECTION_ERROR
                    - HTTP_RESPONSE_ERROR
                    - DECODE_ERROR
                    - SIZE_EXCEEDED
                    - UNKNOWN_ERROR
                  message:
                    type: string
                    description: Human-readable description of the error.
                required:
                - code
                - message
            required:
            - url
            - hash
            - json_metadata
            - bytes
        required:
        - drep_id
        - hex
        - amount
        - has_script
        - retired
        - expired
        - last_active_epoch
        - metadata
      example:
      - drep_id: drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn
        hex: db1bc3c3f99ce68977ceaf27ab4dd917123ef9e73f85c304236eab23
        amount: '2000000'
        has_script: false
        retired: false
        expired: false
        last_active_epoch: 509
        metadata:
          url: https://aaa.xyz/drep.json
          hash: a14a5ad4f36bddc00f92ddb39fd9ac633c0fd43f8bfa57758f9163d10ef916de
          json_metadata:
            '@context':
              CIP100: https://github.com/cardano-foundation/CIPs/blob/master/CIP-0100/README.md#
              CIP119: https://github.com/cardano-foundation/CIPs/blob/master/CIP-0119/README.md#
            hashAlgorithm: blake2b-256
            body:
              givenName: Ryan Williams
              objectives: Buy myself an island.
              motivations: I really would like to own an island.
              qualifications: I have my 100m swimming badge.
          bytes: \x7b0a20202240636f6e74657874223a...
      - drep_id: drep1cxayn4fgy27yaucvhamsvqj3v6835mh3tjjx6x8hdnr4
        hex: c1ba49d52822bc4ef30cbf77060251668f1a6ef15ca46d18f76cc758
        amount: '0'
        has_script: false
        retired: true
        expired: false
        last_active_epoch: 480
        metadata: null
    proposal_metadata_v2:
      type: object
      properties:
        id:
          type: string
          description: Governance Action Identifier (CIP-0129)
        tx_hash:
          type: string
          description: Off-chain metadata of a proposal with a specific transaction hash
        cert_index:
          type: integer
          description: Off-chain metadata of a proposal with a specific transaction cert_index
        url:
          type: string
          example: https://abc.xyz/gov.json
          description: URL to the proposal metadata
        hash:
          type: string
          example: 69c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c"
          description: Hash of the metadata file
        json_metadata:
          anyOf:
          - type: string
          - type: object
            additionalProperties: true
          - type: array
            items: {}
          - type: integer
          - type: number
          - type: boolean
          - type: 'null'
          description: Content of the JSON metadata (validated CIP-108)
        bytes:
          type: string
          description: Content of the metadata (raw)
          nullable: true
        error:
          type: object
          description: Present when metadata could not be fetched or validated.
          properties:
            code:
              type: string
              description: Stable machine-readable error code.
              enum:
              - HASH_MISMATCH
              - CONNECTION_ERROR
              - HTTP_RESPONSE_ERROR
              - DECODE_ERROR
              - SIZE_EXCEEDED
              - UNKNOWN_ERROR
            message:
              type: string
              description: Human-readable description of the error.
          required:
          - code
          - message
      required:
      - id
      - tx_hash
      - cert_index
      - url
      - hash
      - json_metadata
      - bytes
      example:
        id: gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn
        tx_hash: 257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8
        cert_index: 2
        url: https://raw.githubusercontent.com/carloslodelar/proposals/main/pv10.json
        hash: ffa226f3863aca006172d559cf46bb8b883a47233962ae2fc94c158d7de6fa81
        json_metadata:
          body:
            title: Hardfork to Protocol version 10
            abstract: Let's have sanchoNet in full governance as soon as possible
            rationale: Let's keep testing stuff
            motivation: PV9 is not as fun as PV10
            references:
            - uri: ''
              '@type': Other
              label: Hardfork to PV10
          authors:
          - name: Carlos
            witness:
              publicKey: 7ea09a34aebb13c9841c71397b1cabfec5ddf950405293dee496cac2f437480a
              signature: a476985b4cc0d457f247797611799a6f6a80fc8cb7ec9dcb5a8223888d0618e30de165f3d869c4a0d9107d8a5b612ad7c5e42441907f5b91796f0d7187d64a01
              witnessAlgorithm: ed25519
          '@context':
            body:
              '@id': CIP108:body
              '@context':
                title: CIP108:title
                abstract: CIP108:abstract
                rationale: CIP108:rationale
                motivation: CIP108:motivation
                references:
                  '@id': CIP108:references
                  '@context':
                    uri: CIP100:reference-uri
                    Other: CIP100:OtherReference
                    label: CIP100:reference-label
                    referenceHash:
                      '@id': CIP108:referenceHash
                      '@context':
                        hashDigest: CIP108:hashDigest
                        hashAlgorithm: CIP100:hashAlgorithm
                    GovernanceMetadata: CIP100:GovernanceMetadataReference
                  '@container': '@set'
            CIP100: https://github.com/cardano-foundation/CIPs/blob/master/CIP-0100/README.md#
            CIP108: https://github.com/cardano-foundation/CIPs/blob/master/CIP-0108/README.md#
            authors:
              '@id': CIP100:authors
              '@context':
                name: http://xmlns.com/foaf/0.1/name
                witness:
                  '@id': CIP100:witness
                  '@context':
                    publicKey: CIP100:publicKey
                    signature: CIP100:signature
                    witnessAlgorithm: CIP100:witnessAlgorithm
              '@container': '@set'
            '@language': en-us
            hashAlgorithm: CIP100:hashAlgorithm
          hashAlgorithm: blake2b-256
        bytes: \x7b0a20202240636f6e74657874223a207b0a2020202022406c616e6775616765223a2022656e2d7573222c0a2020202022434950313030223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130302f524541444d452e6d6423222c0a2020202022434950313038223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130382f524541444d452e6d6423222c0a202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d222c0a2020202022626f6479223a207b0a20202020202022406964223a20224349503130383a626f6479222c0a2020202020202240636f6e74657874223a207b0a2020202020202020227265666572656e636573223a207b0a2020202020202020202022406964223a20224349503130383a7265666572656e636573222c0a202020202020202020202240636f6e7461696e6572223a202240736574222c0a202020202020202020202240636f6e74657874223a207b0a20202020202020202020202022476f7665726e616e63654d65746164617461223a20224349503130303a476f7665726e616e63654d657461646174615265666572656e6365222c0a202020202020202020202020224f74686572223a20224349503130303a4f746865725265666572656e6365222c0a202020202020202020202020226c6162656c223a20224349503130303a7265666572656e63652d6c6162656c222c0a20202020202020202020202022757269223a20224349503130303a7265666572656e63652d757269222c0a202020202020202020202020227265666572656e636548617368223a207b0a202020202020202020202020202022406964223a20224349503130383a7265666572656e636548617368222c0a20202020202020202020202020202240636f6e74657874223a207b0a202020202020202020202020202020202268617368446967657374223a20224349503130383a68617368446967657374222c0a202020202020202020202020202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d220a20202020202020202020202020207d0a2020202020202020202020207d0a202020202020202020207d0a20202020202020207d2c0a2020202020202020227469746c65223a20224349503130383a7469746c65222c0a2020202020202020226162737472616374223a20224349503130383a6162737472616374222c0a2020202020202020226d6f7469766174696f6e223a20224349503130383a6d6f7469766174696f6e222c0a202020202020202022726174696f6e616c65223a20224349503130383a726174696f6e616c65220a2020202020207d0a202020207d2c0a2020202022617574686f7273223a207b0a20202020202022406964223a20224349503130303a617574686f7273222c0a2020202020202240636f6e7461696e6572223a202240736574222c0a2020202020202240636f6e74657874223a207b0a2020202020202020226e616d65223a2022687474703a2f2f786d6c6e732e636f6d2f666f61662f302e312f6e616d65222c0a2020202020202020227769746e657373223a207b0a2020202020202020202022406964223a20224349503130303a7769746e657373222c0a202020202020202020202240636f6e74657874223a207b0a202020202020202020202020227769746e657373416c676f726974686d223a20224349503130303a7769746e657373416c676f726974686d222c0a202020202020202020202020227075626c69634b6579223a20224349503130303a7075626c69634b6579222c0a202020202020202020202020227369676e6174757265223a20224349503130303a7369676e6174757265220a202020202020202020207d0a20202020202020207d0a2020202020207d0a202020207d0a20207d2c0a20202268617368416c676f726974686d223a2022626c616b6532622d323536222c0a202022626f6479223a207b0a20202020227469746c65223a202248617264666f726b20746f2050726f746f636f6c2076657273696f6e203130222c0a20202020226162737472616374223a20224c6574277320686176652073616e63686f4e657420696e2066756c6c20676f7665726e616e636520617320736f6f6e20617320706f737369626c65222c0a20202020226d6f7469766174696f6e223a2022505639206973206e6f742061732066756e2061732050563130222c0a2020202022726174696f6e616c65223a20224c65742773206b6565702074657374696e67207374756666222c0a20202020227265666572656e636573223a205b0a2020202020207b0a2020202020202020224074797065223a20224f74686572222c0a2020202020202020226c6162656c223a202248617264666f726b20746f2050563130222c0a202020202020202022757269223a2022220a2020202020207d0a202020205d0a20207d2c0a202022617574686f7273223a205b0a202020207b0a202020202020226e616d65223a20224361726c6f73222c0a202020202020227769746e657373223a207b0a2020202020202020227769746e657373416c676f726974686d223a202265643235353139222c0a2020202020202020227075626c69634b6579223a202237656130396133346165626231336339383431633731333937623163616266656335646466393530343035323933646565343936636163326634333734383061222c0a2020202020202020227369676e6174757265223a20226134373639383562346363306434353766323437373937363131373939613666366138306663386362376563396463623561383232333838386430363138653330646531363566336438363963346130643931303764386135623631326164376335653432343431393037663562393137393666306437313837643634613031220a2020202020207d0a202020207d0a20205d0a7d
    drep_votes:
      type: array
      items:
        type: object
        properties:
          tx_hash:
            type: string
            description: Hash of the vote transaction.
          cert_index:
            type: integer
            description: Index of the certificate within the vote transaction.
          proposal_id:
            type: string
            description: Governance Action Identifier (CIP-0129) of the proposal being voted on.
          proposal_tx_hash:
            type: string
            description: Hash of the proposal transaction.
          proposal_cert_index:
            type: integer
            description: Index of the certificate within the proposal transaction.
          vote:
            type: string
            enum:
            - 'yes'
            - 'no'
            - abstain
            description: The Vote. Can be one of yes, no, abstain.
        required:
        - tx_hash
        - cert_index
        - proposal_id
        - proposal_tx_hash
        - proposal_cert_index
        - vote
      example:
      - tx_hash: b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5
        cert_index: 2
        proposal_id: gov_action1k2jertppnnndejjcglszfqq4yzw8evzrd2nt66rr6rqlz54xp0zsq05ecsn
        proposal_tx_hash: b2a591ac219ce6dcca5847e0248015209c7cb0436aa6bd6863d0c1f152a60bc5
        proposal_cert_index: 0
        vote: 'yes'
      - tx_hash: b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5
        cert_index: 3
        proposal_id: gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn
        proposal_tx_hash: 2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531
        proposal_cert_index: 1
        vote: abstain
    committee:
      type: object
      properties:
        gov_action_id:
          type: string
          nullable: true
          description: CIP-129 Governance Action Identifier of the `NewCommittee` action that seated this committee. `null` for the Conway-genesis committee.
        proposal_tx_hash:
          type: string
          nullable: true
          description: Hash of the transaction containing the `NewCommittee` action that seated this committee. `null` for the Conway-genesis committee.
        proposal_index:
          type: integer
          nullable: true
          description: Index of the proposal within its transaction. `null` for the Conway-genesis committee.
        is_dissolved:
          type: boolean
          description: True iff an enacted `NoConfidence` governance action has dissolved this committee.
        quorum:
          type: object
          description: Voting threshold of the committee.
          properties:
            numerator:
              type: integer
            denominator:
              type: integer
          required:
          - numerator
          - denominator
        members:
          type: array
          description: Members of the committee.
          items:
            type: object
            properties:
              cc_cold_id:
                type: string
                description: CIP-129 bech32 encoded cold credential (`cc_cold1...`).
              cc_cold_hex:
                type: string
                description: Hex of the raw 28-byte cold key/script hash.
              cc_cold_has_script:
                type: boolean
              cc_hot_id:
                type: string
                nullable: true
                description: CIP-129 bech32 encoded current hot credential (`cc_hot1...`). `null` unless `status` is `authorized`.
              cc_hot_hex:
                type: string
                nullable: true
              cc_hot_has_script:
                type: boolean
                nullable: true
              status:
                type: string
                enum:
                - authorized
                - not_authorized
                - resigned
                description: '`authorized` — member has a currently active hot key. `not_authorized` — member has never authorized a hot key. `resigned` — member''s most recent on-chain event is a resignation certificate.'
              expiration_epoch:
                type: integer
                description: Epoch at which this member's term expires.
            required:
            - cc_cold_id
            - cc_cold_hex
            - cc_cold_has_script
            - cc_hot_id
            - cc_hot_hex
            - cc_hot_has_script
            - status
            - expiration_epoch
      required:
      - proposal_tx_hash
      - proposal_index
      - gov_action_id
      - is_dissolved
      - quorum
      - members
      example:
        proposal_tx_hash: null
        proposal_index: null
        gov_action_id: null
        is_dissolved: false
        quorum:
          numerator: 2
          denominator: 3
        members:
        - cc_cold_id: cc_cold1zgkfeeu07qq9smfqfn0nrf2cqgr5x6jpu8x6lxgxay85t6cmt54xz
          cc_cold_hex: 12c9ce78ff8005436901336f8d2ac0411a1b520f0e6d7e6066907a2f
          cc_cold_has_script: false
          cc_hot_id: cc_hot1qf4xq9mlra5j68w8zjz2lvf3kc3rtsdtu98ka7zx4u6jvqyy39ww0
          cc_hot_hex: 0269808bbf8fb495a3b8e290a5f626362236c1abf853eddf08d79a930
          cc_hot_has_script: false
          status: authorized
          expiration_epoch: 580
        - cc_cold_id: cc_cold1zgxxx2trz0vyl5ksetnsrct5n5gznn3jmkj6dlpu4lz6lecz5h
          cc_cold_hex: 8cc6529626c4c9fa5a195ce03c2e93a204e7193b76967e8794fc59d6
          cc_cold_has_script: false
          cc_hot_id: null
          cc_hot_hex: null
          cc_hot_has_script: null
          status: not_authorized
          expiration_epoch: 580
    proposal_metadata:
      type: object
      properties:
        id:
          type: string
          description: Governance Action Identifier (CIP-0129)
        tx_hash:
          type: string
          description: Off-chain metadata of a proposal with a specific transaction hash
        cert_index:
          type: integer
          description: Off-chain metadata of a proposal with a specific transaction cert_index
        url:
          type: string
          example: https://abc.xyz/gov.json
          description: URL to the proposal metadata
        hash:
          type: string
          example: 69c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c"
          description: Hash of the metadata file
        json_metadata:
          anyOf:
          - type: string
          - type: object
            additionalProperties: true
          - type: array
            items: {}
          - type: integer
          - type: number
          - type: boolean
          - type: 'null'
          description: Content of the JSON metadata (validated CIP-108)
        bytes:
          type: string
          description: Content of the metadata (raw)
      required:
      - id
      - tx_hash
      - cert_index
      - url
      - hash
      - json_metadata
      - bytes
      example:
        id: gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn
        tx_hash: 257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8
        cert_index: 2
        url: https://raw.githubusercontent.com/carloslodelar/proposals/main/pv10.json
        hash: ffa226f3863aca006172d559cf46bb8b883a47233962ae2fc94c158d7de6fa81
        json_metadata:
          body:
            title: Hardfork to Protocol version 10
            abstract: Let's have sanchoNet in full governance as soon as possible
            rationale: Let's keep testing stuff
            motivation: PV9 is not as fun as PV10
            references:
            - uri: ''
              '@type': Other
              label: Hardfork to PV10
          authors:
          - name: Carlos
            witness:
              publicKey: 7ea09a34aebb13c9841c71397b1cabfec5ddf950405293dee496cac2f437480a
              signature: a476985b4cc0d457f247797611799a6f6a80fc8cb7ec9dcb5a8223888d0618e30de165f3d869c4a0d9107d8a5b612ad7c5e42441907f5b91796f0d7187d64a01
              witnessAlgorithm: ed25519
          '@context':
            body:
              '@id': CIP108:body
              '@context':
                title: CIP108:title
                abstract: CIP108:abstract
                rationale: CIP108:rationale
                motivation: CIP108:motivation
                references:
                  '@id': CIP108:references
                  '@context':
                    uri: CIP100:reference-uri
                    Other: CIP100:OtherReference
                    label: CIP100:reference-label
                    referenceHash:
                      '@id': CIP108:referenceHash
                      '@context':
                        hashDigest: CIP108:hashDigest
                        hashAlgorithm: CIP100:hashAlgorithm
                    GovernanceMetadata: CIP100:GovernanceMetadataReference
                  '@container': '@set'
            CIP100: https://github.com/cardano-foundation/CIPs/blob/master/CIP-0100/README.md#
            CIP108: https://github.com/cardano-foundation/CIPs/blob/master/CIP-0108/README.md#
            authors:
              '@id': CIP100:authors
              '@context':
                name: http://xmlns.com/foaf/0.1/name
                witness:
                  '@id': CIP100:witness
                  '@context':
                    publicKey: CIP100:publicKey
                    signature: CIP100:signature
                    witnessAlgorithm: CIP100:witnessAlgorithm
              '@container': '@set'
            '@language': en-us
            hashAlgorithm: CIP100:hashAlgorithm
          hashAlgorithm: blake2b-256
        bytes: \x7b0a20202240636f6e74657874223a207b0a2020202022406c616e6775616765223a2022656e2d7573222c0a2020202022434950313030223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130302f524541444d452e6d6423222c0a2020202022434950313038223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130382f524541444d452e6d6423222c0a202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d222c0a2020202022626f6479223a207b0a20202020202022406964223a20224349503130383a626f6479222c0a2020202020202240636f6e74657874223a207b0a2020202020202020227265666572656e636573223a207b0a2020202020202020202022406964223a20224349503130383a7265666572656e636573222c0a202020202020202020202240636f6e7461696e6572223a202240736574222c0a202020202020202020202240636f6e74657874223a207b0a20202020202020202020202022476f7665726e616e63654d65746164617461223a20224349503130303a476f7665726e616e63654d657461646174615265666572656e6365222c0a202020202020202020202020224f74686572223a20224349503130303a4f746865725265666572656e6365222c0a202020202020202020202020226c6162656c223a20224349503130303a7265666572656e63652d6c6162656c222c0a20202020202020202020202022757269223a20224349503130303a7265666572656e63652d757269222c0a202020202020202020202020227265666572656e636548617368223a207b0a202020202020202020202020202022406964223a20224349503130383a7265666572656e636548617368222c0a20202020202020202020202020202240636f6e74657874223a207b0a202020202020202020202020202020202268617368446967657374223a20224349503130383a68617368446967657374222c0a202020202020202020202020202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d220a20202020202020202020202020207d0a2020202020202020202020207d0a202020202020202020207d0a20202020202020207d2c0a2020202020202020227469746c65223a20224349503130383a7469746c65222c0a2020202020202020226162737472616374223a20224349503130383a6162737472616374222c0a2020202020202020226d6f7469766174696f6e223a20224349503130383a6d6f7469766174696f6e222c0a202020202020202022726174696f6e616c65223a20224349503130383a726174696f6e616c65220a2020202020207d0a202020207d2c0a2020202022617574686f7273223a207b0a20202020202022406964223a20224349503130303a617574686f7273222c0a2020202020202240636f6e7461696e6572223a202240736574222c0a2020202020202240636f6e74657874223a207b0a2020202020202020226e616d65223a2022687474703a2f2f786d6c6e732e636f6d2f666f61662f302e312f6e616d65222c0a2020202020202020227769746e657373223a207b0a2020202020202020202022406964223a20224349503130303a7769746e657373222c0a202020202020202020202240636f6e74657874223a207b0a202020202020202020202020227769746e657373416c676f726974686d223a20224349503130303a7769746e657373416c676f726974686d222c0a202020202020202020202020227075626c69634b6579223a20224349503130303a7075626c69634b6579222c0a202020202020202020202020227369676e6174757265223a20224349503130303a7369676e6174757265220a202020202020202020207d0a20202020202020207d0a2020202020207d0a202020207d0a20207d2c0a20202268617368416c676f726974686d223a2022626c616b6532622d323536222c0a202022626f6479223a207b0a20202020227469746c65223a202248617264666f726b20746f2050726f746f636f6c2076657273696f6e203130222c0a20202020226162737472616374223a20224c6574277320686176652073616e63686f4e657420696e2066756c6c20676f7665726e616e636520617320736f6f6e20617320706f737369626c65222c0a20202020226d6f7469766174696f6e223a2022505639206973206e6f742061732066756e2061732050563130222c0a2020202022726174696f6e616c65223a20224c65742773206b6565702074657374696e67207374756666222c0a20202020227265666572656e636573223a205b0a2020202020207b0a2020202020202020224074797065223a20224f74686572222c0a2020202020202020226c6162656c223a202248617264666f726b20746f2050563130222c0a202020202020202022757269223a2022220a2020202020207d0a202020205d0a20207d2c0a202022617574686f7273223a205b0a202020207b0a202020202020226e616d65223a20224361726c6f73222c0a202020202020227769746e657373223a207b0a2020202020202020227769746e657373416c676f726974686d223a202265643235353139222c0a2020202020202020227075626c69634b6579223a202237656130396133346165626231336339383431633731333937623163616266656335646466393530343035323933646565343936636163326634333734383061222c0a2020202020202020227369676e6174757265223a20226134373639383562346363306434353766323437373937363131373939613666366138306663386362376563396463623561383232333838386430363138653330646531363566336438363963346130643931303764386135623631326164376335653432343431393037663562393137393666306437313837643634613031220a2020202020207d0a202020207d0a20205d0a7d
    proposal_parameters:
      type: object
      properties:
        id:
          type: string
          description: Governance Action Identifier (CIP-0129)
        tx_hash:
          type: string
          description: Off-chain metadata of a proposal with a specific transaction hash
        cert_index:
          type: integer
          description: Off-chain metadata of a proposal with a specific transaction cert_index
        parameters:
          type: object
          properties:
            epoch:
              type: integer
              example: 225
              description: Epoch number
              nullable: true
            min_fee_a:
              type: integer
              example: 44
              description: The linear factor for the minimum fee calculation for given epoch
              nullable: true
            min_fee_b:
              type: integer
              example: 155381
              description: The constant factor for the minimum fee calculation
              nullable: true
            max_block_size:
              type: integer
              example: 65536
              description: Maximum block body size in Bytes
              nullable: true
            max_tx_size:
              type: integer
              example: 16384
              description: Maximum transaction size
              nullable: true
            max_block_header_size:
              type: integer
              example: 1100
              description: Maximum block header size
              nullable: true
            key_deposit:
              type: string
              example: '2000000'
              description: The amount of a key registration deposit in Lovelaces
              nullable: true
            pool_deposit:
              type: string
              example: '500000000'
              description: The amount of a pool registration deposit in Lovelaces
              nullable: true
            e_max:
              type: integer
              example: 18
              description: Epoch bound on pool retirement
              nullable: true
            n_opt:
              type: integer
              example: 150
              description: Desired number of pools
              nullable: true
            a0:
              type: number
              example: 0.3
              description: Pool pledge influence
              nullable: true
            rho:
              type: number
              example: 0.003
              description: Monetary expansion
              nullable: true
            tau:
              type: number
              example: 0.2
              description: Treasury expansion
              nullable: true
            decentralisation_param:
              type: number
              example: 0.5
              description: Percentage of blocks produced by federated nodes
              nullable: true
            extra_entropy:
              type: string
              nullable: true
              example: null
              description: Seed for extra entropy
            protocol_major_ver:
              type: integer
              example: 2
              description: Accepted protocol major version
              nullable: true
            protocol_minor_ver:
              type: integer
              example: 0
              description: Accepted protocol minor version
              nullable: true
            min_utxo:
              type: string
              example: '1000000'
              description: Minimum UTXO value
              nullable: true
            min_pool_cost:
              type: string
              example: '340000000'
              description: Minimum stake cost forced on the pool
              nullable: true
            cost_models:
              additionalProperties: true
              type: object
              nullable: true
              example:
                PlutusV1:
                - 197209
                - 0
                PlutusV2:
                - 197209
                - 0
              description: Cost models parameters for Plutus Core scripts in raw list form
            price_mem:
              type: number
              nullable: true
              example: 0.0577
              description: The per word cost of script memory usage
            price_step:
              type: number
              nullable: true
              example: 7.21e-05
              description: The cost of script execution step usage
            max_tx_ex_mem:
              type: string
              nullable: true
              example: '10000000'
              description: The maximum number of execution memory allowed to be used in a single transaction
            max_tx_ex_steps:
              type: string
              nullable: true
              example: '10000000000'
              description: The maximum number of execution steps allowed to be used in a single transaction
            max_block_ex_mem:
              type: string
              nullable: true
              example: '50000000'
              description: The maximum number of execution memory allowed to be used in a single block
            max_block_ex_steps:
              type: string
              nullable: true
              example: '40000000000'
              description: The maximum number of execution steps allowed to be used in a single block
            max_val_size:
              type: string
              nullable: true
              example: '5000'
              description: The maximum Val size
            collateral_percent:
              type: integer
              nullable: true
              example: 150
              description: The percentage of the transactions fee which must be provided as collateral when including non-native scripts
            max_collateral_inputs:
              type: integer
              nullable: true
              example: 3
              description: The maximum number of collateral inputs allowed in a transaction
            coins_per_utxo_size:
              type: string
              nullable: true
              example: '34482'
              description: Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later.
            coins_per_utxo_word:
              type: string
              nullable: true
              example: '34482'
              deprecated: true
              description: Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later.
            pvt_motion_no_confidence:
              type: number
              nullable: true
              description: Pool Voting threshold for motion of no-confidence. New in 13.2-Conway.
            pvt_committee_normal:
              type: number
              nullable: true
              description: Pool Voting threshold for new committee/threshold (normal state). New in 13.2-Conway.
            pvt_committee_no_confidence:
              type: number
              nullable: true
              description: Pool Voting threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway.
            pvt_hard_fork_initiation:
              type: number
              nullable: true
              description: Pool Voting threshold for hard-fork initiation. New in 13.2-Conway.
            dvt_motion_no_confidence:
              type: number
              nullable: true
              description: DRep Vote threshold for motion of no-confidence. New in 13.2-Conway.
            dvt_committee_normal:
              type: number
              nullable: true
              description: DRep Vote threshold for new committee/threshold (normal state). New in 13.2-Conway.
            dvt_committee_no_confidence:
              type: number
              nullable: true
              description: DRep Vote threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway.
            dvt_update_to_constitution:
              type: number
              nullable: true
              description: DRep Vote threshold for update to the Constitution. New in 13.2-Conway.
            dvt_hard_fork_initiation:
              type: number
              nullable: true
              description: DRep Vote threshold for hard-fork initiation. New in 13.2-Conway.
            dvt_p_p_network_group:
              type: number
              nullable: true
              description: DRep Vote threshold for protocol parameter changes, network group. New in 13.2-Conway.
            dvt_p_p_economic_group:
              type: number
              nullable: true
              description: DRep Vote threshold for protocol parameter changes, economic group. New in 13.2-Conway.
            dvt_p_p_technical_group:
              type: number
              nullable: true
              description: DRep Vote threshold for protocol parameter changes, technical group. New in 13.2-Conway.
            dvt_p_p_gov_group:
              type: number
              nullable: true
              description: DRep Vote threshold for protocol parameter changes, governance group. New in 13.2-Conway.
            dvt_treasury_withdrawal:
              type: number
              nullable: true
              description: DRep Vote threshold for treasury withdrawal. New in 13.2-Conway.
            committee_min_size:
              type: string
              nullable: true
              format: word64type
              description: Minimal constitutional committee size. New in 13.2-Conway.
            committee_max_term_length:
              type: string
              nullable: true
              format: word64type
              description: Constitutional committee term limits. New in 13.2-Conway.
            gov_action_lifetime:
              type: string
              nullable: true
              format: word64type
              description: Governance action expiration. New in 13.2-Conway.
            gov_action_deposit:
              type: string
              nullable: true
              format: word64type
              description: Governance action deposit. New in 13.2-Conway.
            drep_deposit:
              type: string
              nullable: true
              format: word64type
              description: DRep deposit amount. New in 13.2-Conway.
            drep_activity:
              type: string
              nullable: true
              format: word64type
              description: DRep activity period. New in 13.2-Conway.
            pvtpp_security_group:
              type: number
              nullable: true
              deprecated: true
              description: Pool Voting threshold for security-relevant protocol parameters changes. Renamed to pvt_p_p_security_group.
            pvt_p_p_security_group:
              type: number
              nullable: true
              description: Pool Voting threshold for security-relevant protocol parameters changes.
            min_fee_ref_script_cost_per_byte:
              type: number
              nullable: true
          required:
          - min_fee_a
          - min_fee_b
          - max_block_size
          - max_tx_size
          - max_block_header_size
          - key_deposit
          - pool_deposit
          - e_max
          - n_opt
          - a0
          - rho
          - tau
          - decentralisation_param
          - extra_entropy
          - protocol_major_ver
          - protocol_minor_ver
          - min_utxo
          - min_pool_cost
          - cost_models
          - price_mem
          - price_step
          - max_tx_ex_mem
          - max_tx_ex_steps
          - max_block_ex_mem
          - max_block_ex_steps
          - max_val_size
          - collateral_percent
          - max_collateral_inputs
          - coins_per_utxo_size
          - coins_per_utxo_word
          - pvt_motion_no_confidence
          - pvt_committee_normal
          - pvt_committee_no_confidence
          - pvt_hard_fork_initiation
          - dvt_motion_no_confidence
          - dvt_committee_normal
          - dvt_committee_no_confidence
          - dvt_update_to_constitution
          - dvt_hard_fork_initiation
          - dvt_p_p_network_group
          - dvt_p_p_economic_group
          - dvt_p_p_technical_group
          - dvt_p_p_gov_group
          - dvt_treasury_withdrawal
          - committee_min_size
          - committee_max_term_length
          - gov_action_lifetime
          - gov_action_deposit
          - drep_deposit
          - drep_activity
          - pvtpp_security_group
          - pvt_p_p_security_group
          - min_fee_ref_script_cost_per_byte
      required:
      - id
      - tx_hash
      - cert_index
      - parameters
    proposal_votes:
      type: array
      items:
        type: object
        properties:
          tx_hash:
            type: string
            description: Hash of the voting transaction.
          cert_index:
            type: integer
            description: Index of the certificate within the voting transaction.
          voter_role:
            type: string
            enum:
            - constitutional_committee
            - drep
            - spo
            description: The role of the voter. Can be one of constitutional_committee, drep, spo.
          voter:
            type: string
            description: The actual voter.
          vote:
            type: string
            enum:
            - 'yes'
            - 'no'
            - abstain
            description: The Vote. Can be one of yes, no, abstain.
        required:
        - tx_hash
        - cert_index
        - voter_role
        - voter
        - vote
      example:
      - tx_hash: b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5
        cert_index: 2
        voter_role: drep
        voter: drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn
        vote: 'yes'
      - tx_hash: b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5
        cert_index: 3
        voter_role: constitutional_committee
        voter: 53a42debdc7ffd90085ab7fd9800b63e6d1c9ac481ba6eb7b6a844e4
        vote: abstain
    drep_delegators:
      type: array
      items:
        type: object
        properties:
          address:
            type: string
            description: Bech32 encoded stake addresses
          amount:
            type: string
            description: Currently delegated amount
        required:
        - address
        - amount
      example:
      - address: stake1ux4vspfvwuus9uwyp5p3f0ky7a30jq5j80jxse0fr7pa56sgn8kha
        amount: '1137959159981411'
      - address: stake1uylayej7esmarzd4mk4aru37zh9yz0luj3g9fsvgpfaxulq564r5u
        amount: '16958865648'
      - address: stake1u8lr2pnrgf8f7vrs9lt79hc3sxm8s2w4rwvgpncks3axx6q93d4ck
        amount: '18605647'
  responses:
    '400':
      description: Bad request
      content:
        application/json:
          schema:
            type: object
            properties:
              status_code:
                type: integer
                example: 400
              error:
                type: string
                example: Bad Request
              message:
                type: string
                example: Backend did not understand your request.
            required:
            - error
            - message
            - status_code
    '429':
      description: Usage limit reached
      content:
        application/json:
          schema:
            type: object
            properties:
              status_code:
                type: integer
                example: 429
              error:
                type: string
                example: Project Over Limit
              message:
                type: string
                example: Usage is over limit.
            required:
            - error
            - message
            - status_code
    '403':
      description: Authentication secret is missing or invalid
      content:
        application/json:
          schema:
            type: object
            properties:
              status_code:
                type: integer
                example: 403
              error:
                type: string
                example: Forbidden
              message:
                type: string
                example: Invalid project token.
            required:
            - error
            - message
            - status_code
    '500':
      description: Internal Server Error
      content:
        application/json:
          schema:
            type: object
            properties:
              status_code:
                type: integer
                example: 500
              error:
                type: string
                example: Internal Server Error
              message:
                type: string
                example: An unexpected response was received from the backend.
            required:
            - error
            - message
            - status_code
    '404':
      description: Component not found
      content:
        application/json:
          schema:
            type: object
            properties:
              status_code:
                type: integer
                example: 404
              error:
                type: string
                example: Not Found
              message:
                type: string
                example: The requested component has not been found.
            required:
            - error
            - message
            - status_code
    '418':
      description: IP has been auto-banned for extensive sending of requests after usage limit has been reached
      content:
        application/json:
          schema:
            type: object
            properties:
              status_code:
                type: integer
                example: 418
              error:
                type: string
                example: Requested Banned
              message:
                type: string
                example: IP has been auto-banned for flooding.
            required:
            - error
            - message
            - status_code
  securitySchemes:
    project_id:
      type: apiKey
      in: header
      name: project_id
      description: 'There are multiple token types available based on network you choose

        when creating a Blockfrost a project, for a list of token types

        see available networks.

        '