Polkadot

Polkadot Governance API

The Governance API from Polkadot — 40 operation(s) for governance.

GitHub OpenAPI

Operations 40

POST /api/scan/account/referendum List governance items for an account
POST /api/scan/bounties/child List child bounties
POST /api/scan/bounties/proposal Get bounty details
POST /api/scan/bounties/proposals List bounties
POST /api/scan/council/proposal Get council proposal details
POST /api/scan/council/proposals List council proposals
POST /api/scan/democracy/proposal Get democracy proposal details
POST /api/scan/democracy/proposals List democracy proposals
POST /api/scan/democracy/referendum Get democracy referendum details (legacy)
POST /api/scan/democracy/referendums List democracy referendums
POST /api/scan/democracy/seconded List democracy seconders
POST /api/scan/democracy/votes List democracy referendum votes (legacy)
POST /api/scan/fellowship/referendum Get fellowship referendum details
POST /api/scan/fellowship/referendums List fellowship referenda
POST /api/scan/fellowship/statistics Get fellowship referendum statistics
POST /api/scan/fellowship/tracks List fellowship referendum tracks
POST /api/scan/fellowship/votes List fellowship referendum votes
POST /api/scan/governance/desc Get external discussion for a governance item
POST /api/scan/preimage/details Get governance preimage details
POST /api/scan/preimage/list List governance preimages
POST /api/scan/referenda/delegate Get referendum delegator details
POST /api/scan/referenda/delegate/votes List referendum delegator votes
POST /api/scan/referenda/delegates List referendum delegation relationships
POST /api/scan/referenda/referendum Get OpenGov referendum details
POST /api/scan/referenda/referendums List OpenGov referenda
POST /api/scan/referenda/statistics Get referendum statistics
POST /api/scan/referenda/tracks List referendum tracks
POST /api/scan/referenda/votes List OpenGov referendum votes
POST /api/scan/techcomm/proposal Get technical-committee proposal details
POST /api/scan/techcomm/proposals List technical-committee proposals
POST /api/scan/treasury/proposal Get treasury proposal details
POST /api/scan/treasury/proposals List treasury proposals
POST /api/scan/treasury/tip Get treasury tip details
POST /api/scan/treasury/tippers List treasury tippers
POST /api/scan/treasury/tips List treasury tips
POST /api/scan/treasury_council_collective/proposal Get treasury council collective proposal details
POST /api/scan/treasury_council_collective/proposals List treasury council collective proposals
POST /api/scan/treasury_council_collective/votes List treasury council collective votes
POST /api/scan/treasury_spend/proposal Get treasury spend proposal details
POST /api/scan/treasury_spend/proposals List treasury spend proposals

Documentation

📖
Documentation
https://support.subscan.io/
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/polkadot/refs/heads/main/rate-limits/subscan.yml
📖
Documentation
https://docs.polkadot.com/chain-interactions/query-data/query-rest/
📖
Documentation
https://github.com/paritytech/polkadot-rest-api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/polkadot/refs/heads/main/openapi/polkadot-governance-api-openapi.yml

SDKs

📦
GitHubRepository
https://github.com/paritytech/substrate-api-sidecar
📦
GitHubRepository
https://github.com/paritytech/polkadot-rest-api

Other Resources

🔗
PostmanCollection
https://documenter.getpostman.com/view/1618960/TVCe1oRU
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/polkadot/refs/heads/main/plans/subscan.yml
🔗
FinOps
https://raw.githubusercontent.com/api-evangelist/polkadot/refs/heads/main/finops/subscan.yml

Work with this as data

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

MCP server

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

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/polkadot-governance-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

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

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

polkadot-governance-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: bruce.sun@itering.io
    name: API Support
    url: http://www.swagger.io/support
  description: This is a subscan API server.
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: http://swagger.io/terms/
  title: Subscan Governance API
  version: '1.0'
servers:
- url: https://https://www.subscan.io/
tags:
- name: Governance
paths:
  /api/scan/account/referendum:
    post:
      description: 'Returns paginated referendum or democracy items associated with the specified account.

        This API only supports networks with democracy frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        count:
                          type: integer
                        list:
                          items:
                            $ref: '#/components/schemas/subscan_internal_model.AccountReferendumJson'
                          type: array
                      type: object
                  type: object
      summary: List governance items for an account
      tags:
      - Governance
      x-synonyms:
      - account
      - referendum
      - governance
      - scan
      - wallet
      - address
      - user
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.accountReferendumParams'
        description: params
        required: true
  /api/scan/bounties/child:
    post:
      description: 'Returns a paginated child-bounty list, optionally filtered by parent bounty ID.

        This API only supports networks with childbounties frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        count:
                          type: integer
                        list:
                          items:
                            $ref: '#/components/schemas/subscan_internal_model.ChildBountySampleJson'
                          type: array
                      type: object
                  type: object
      summary: List child bounties
      tags:
      - Governance
      x-synonyms:
      - child
      - bounty
      - governance
      - scan
      - bounties
      - referendum
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.childBountiesParams'
        description: params
        required: true
  /api/scan/bounties/proposal:
    post:
      description: 'Returns details for one bounty proposal.

        This API only supports networks with bounties frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      $ref: '#/components/schemas/subscan_internal_model.BountyJson'
                  type: object
      summary: Get bounty details
      tags:
      - Governance
      x-synonyms:
      - bounty
      - governance
      - scan
      - bounties
      - proposal
      - referendum
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.bountyParams'
        description: params
        required: true
  /api/scan/bounties/proposals:
    post:
      description: 'Returns a paginated bounty list with optional status filtering.

        This API only supports networks with bounties frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        count:
                          type: integer
                        list:
                          items:
                            $ref: '#/components/schemas/subscan_internal_model.BountySampleJson'
                          type: array
                      type: object
                  type: object
      summary: List bounties
      tags:
      - Governance
      x-synonyms:
      - bounty
      - governance
      - scan
      - bounties
      - proposals
      - referendum
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.bountiesParams'
        description: params
        required: true
  /api/scan/council/proposal:
    post:
      description: 'Returns details for one council proposal.

        This API only supports networks with council frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        info:
                          $ref: '#/components/schemas/subscan_internal_model.CouncilProposalJson'
                      type: object
                  type: object
      summary: Get council proposal details
      tags:
      - Governance
      x-synonyms:
      - council
      - proposal
      - governance
      - scan
      - referendum
      - vote
      - treasury
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.councilProposalParams'
        description: params
        required: true
  /api/scan/council/proposals:
    post:
      description: 'Returns a paginated council proposal list.

        This API only supports networks with council frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        count:
                          type: integer
                        list:
                          items:
                            $ref: '#/components/schemas/subscan_internal_model.TechcommProposalSample'
                          type: array
                      type: object
                  type: object
      summary: List council proposals
      tags:
      - Governance
      x-synonyms:
      - council
      - proposals
      - governance
      - scan
      - referendum
      - vote
      - treasury
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.councilProposalsParams'
        description: params
        required: true
  /api/scan/democracy/proposal:
    post:
      description: 'Returns details for one democracy proposal.

        This API only supports networks with democracy frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        info:
                          $ref: '#/components/schemas/subscan_internal_model.DemocracyJson'
                      type: object
                  type: object
      summary: Get democracy proposal details
      tags:
      - Governance
      x-synonyms:
      - democracy
      - governance
      - scan
      - proposal
      - referendum
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.democracyParams'
        description: params
        required: true
  /api/scan/democracy/proposals:
    post:
      description: 'Returns a paginated democracy proposal list with optional status and ordering controls.

        This API only supports networks with democracy frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        count:
                          type: integer
                        list:
                          items:
                            $ref: '#/components/schemas/subscan_internal_model.DemocracySampleJson'
                          type: array
                      type: object
                  type: object
      summary: List democracy proposals
      tags:
      - Governance
      x-synonyms:
      - democracies
      - governance
      - scan
      - democracy
      - proposals
      - referendum
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.democraciesParams'
        description: params
        required: true
  /api/scan/democracy/referendum:
    post:
      description: 'Returns details for one legacy democracy referendum.

        This API only supports networks with democracy frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        info:
                          $ref: '#/components/schemas/subscan_internal_model.ReferendumJson'
                      type: object
                  type: object
      summary: Get democracy referendum details (legacy)
      tags:
      - Governance
      x-synonyms:
      - referendum
      - legacy
      - governance
      - scan
      - democracy
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.referendumParams'
        description: params
        required: true
  /api/scan/democracy/referendums:
    post:
      description: 'Returns a paginated democracy referendum list with optional active/completed status filtering.

        This API only supports networks with democracy frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        count:
                          type: integer
                        list:
                          items:
                            $ref: '#/components/schemas/subscan_internal_model.DemocracyReferendumSampleJson'
                          type: array
                      type: object
                  type: object
      summary: List democracy referendums
      tags:
      - Governance
      x-synonyms:
      - referendums
      - governance
      - scan
      - democracy
      - referendum
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.referendumsParams'
        description: params
        required: true
  /api/scan/democracy/seconded:
    post:
      description: 'Returns the accounts that seconded a democracy proposal.

        This API only supports networks with democracy frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        count:
                          type: integer
                        list:
                          items:
                            $ref: '#/components/schemas/subscan_internal_model.DemocracyProposalSeconded'
                          type: array
                      type: object
                  type: object
      summary: List democracy seconders
      tags:
      - Governance
      x-synonyms:
      - democracy
      - seconded
      - governance
      - scan
      - referendum
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.democracySecondedParams'
        description: params
        required: true
  /api/scan/democracy/votes:
    post:
      description: 'Returns paginated vote records for a legacy democracy referendum or account.

        This API only supports networks with democracy frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        count:
                          type: integer
                        list:
                          items:
                            $ref: '#/components/schemas/subscan_internal_model.DemocracyVoteJson'
                          type: array
                      type: object
                  type: object
      summary: List democracy referendum votes (legacy)
      tags:
      - Governance
      x-synonyms:
      - referendum
      - votes
      - legacy
      - governance
      - scan
      - democracy
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.referendumVotesParams'
        description: params
        required: true
  /api/scan/fellowship/referendum:
    post:
      description: 'Returns details for one fellowship referendum.

        This API only supports networks with FellowshipReferenda frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      $ref: '#/components/schemas/subscan_internal_model.ReferendumV2Json'
                  type: object
      summary: Get fellowship referendum details
      tags:
      - Governance
      x-synonyms:
      - fellowship
      - referenda
      - governance
      - scan
      - referendum
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.fellowshipReferendumParams'
        description: params
        required: true
  /api/scan/fellowship/referendums:
    post:
      description: 'Returns a paginated fellowship referenda list with origin, account, and call filters.

        This API only supports networks with FellowshipReferenda frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        count:
                          type: integer
                        list:
                          items:
                            $ref: '#/components/schemas/subscan_internal_model.ReferendumV2SampleJson'
                          type: array
                      type: object
                  type: object
      summary: List fellowship referenda
      tags:
      - Governance
      x-synonyms:
      - fellowship
      - referenda
      - governance
      - scan
      - referendums
      - referendum
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.fellowshipReferendumsV2Params'
        description: params
        required: true
  /api/scan/fellowship/statistics:
    post:
      description: 'Returns aggregated statistics for fellowship referenda.

        This API only supports networks with FellowshipReferenda frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      $ref: '#/components/schemas/subscan_internal_model.FellowshipReferendumStatisticsJson'
                  type: object
      summary: Get fellowship referendum statistics
      tags:
      - Governance
      x-synonyms:
      - fellowship
      - referendum
      - statistics
      - governance
      - scan
      - vote
      - treasury
      - council
  /api/scan/fellowship/tracks:
    post:
      description: 'Returns the available fellowship referendum tracks for the current network.

        This API only supports networks with FellowshipReferenda frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      additionalProperties:
                        $ref: '#/components/schemas/subscan_libs_substrate_storage.ReferendumTracksInfo'
                      type: object
                  type: object
      summary: List fellowship referendum tracks
      tags:
      - Governance
      x-synonyms:
      - fellowship
      - referendum
      - tracks
      - governance
      - scan
      - vote
      - treasury
      - council
  /api/scan/fellowship/votes:
    post:
      description: 'Returns paginated vote records for one fellowship referendum.

        This API only supports networks with FellowshipReferenda frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        count:
                          type: integer
                        list:
                          items:
                            $ref: '#/components/schemas/subscan_internal_model.ConvictionVoteJson'
                          type: array
                      type: object
                  type: object
      summary: List fellowship referendum votes
      tags:
      - Governance
      x-synonyms:
      - fellowship
      - referendum
      - votes
      - governance
      - scan
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.fellowshipReferendumVotesParams'
        description: params
        required: true
  /api/scan/governance/desc:
    post:
      description: Returns external governance posts and comments for the specified item. This endpoint is powered by Subsquare.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      $ref: '#/components/schemas/subscan_libs_opengovResource.PostData'
                  type: object
      summary: Get external discussion for a governance item
      tags:
      - Governance
      x-synonyms:
      - more
      - information
      - about
      - governance
      - scan
      - desc
      - referendum
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.governanceDescParam'
        description: params
        required: true
  /api/scan/preimage/details:
    post:
      description: 'Returns details for one governance preimage by hash.

        This API only supports networks with preimage frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      $ref: '#/components/schemas/subscan_internal_model.PreimageJson'
                  type: object
      summary: Get governance preimage details
      tags:
      - Governance
      x-synonyms:
      - preimage
      - governance
      - scan
      - referendum
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.preimageDetailsParams'
        description: params
        required: true
  /api/scan/preimage/list:
    post:
      description: 'Returns a paginated preimage list with optional status and source filters.

        This API only supports networks with preimage frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        count:
                          type: integer
                        list:
                          items:
                            $ref: '#/components/schemas/subscan_internal_model.PreimageSampleJson'
                          type: array
                      type: object
                  type: object
      summary: List governance preimages
      tags:
      - Governance
      x-synonyms:
      - preimage
      - governance
      - scan
      - referendum
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.preimageListParams'
        description: params
        required: true
  /api/scan/referenda/delegate:
    post:
      description: 'Returns delegation details for one account in the referenda system.

        This API only supports networks with referenda frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      $ref: '#/components/schemas/subscan_internal_model.ReferendumDelegateDetailsJson'
                  type: object
      summary: Get referendum delegator details
      tags:
      - Governance
      x-synonyms:
      - referendum
      - delegator
      - governance
      - scan
      - referenda
      - delegate
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.referendumDelegateDetailsParams'
        description: params
        required: true
  /api/scan/referenda/delegate/votes:
    post:
      description: 'Returns paginated referendum vote records for one delegator or delegate account.

        This API only supports networks with referenda frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        count:
                          type: integer
                        list:
                          items:
                            $ref: '#/components/schemas/subscan_internal_model.ConvictionDelegateVoteJson'
                          type: array
                      type: object
                  type: object
      summary: List referendum delegator votes
      tags:
      - Governance
      x-synonyms:
      - referendum
      - delegator
      - votes
      - governance
      - scan
      - referenda
      - delegate
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.referendumDelegateVotesParams'
        description: params
        required: true
  /api/scan/referenda/delegates:
    post:
      description: 'Returns paginated delegation relationships for one account, including active and delegator/delegate filters.

        This API only supports networks with referenda frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        count:
                          type: integer
                        list:
                          items:
                            $ref: '#/components/schemas/subscan_internal_model.ReferendumDelegateJson'
                          type: array
                      type: object
                  type: object
      summary: List referendum delegation relationships
      tags:
      - Governance
      x-synonyms:
      - referendum
      - delegated
      - delegator
      - governance
      - scan
      - referenda
      - delegates
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.referendumDelegateParams'
        description: params
        required: true
  /api/scan/referenda/referendum:
    post:
      description: 'Returns details for one OpenGov referendum.

        This API only supports networks with referenda frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      $ref: '#/components/schemas/subscan_internal_model.ReferendumV2Json'
                  type: object
      summary: Get OpenGov referendum details
      tags:
      - Governance
      x-synonyms:
      - referenda
      - governance
      - scan
      - referendum
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.referendumV2Params'
        description: params
        required: true
  /api/scan/referenda/referendums:
    post:
      description: 'Returns a paginated referenda list with origin, status, account, and call filters.

        This API only supports networks with referenda frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        count:
                          type: integer
                        list:
                          items:
                            $ref: '#/components/schemas/subscan_internal_model.ReferendumV2SampleJson'
                          type: array
                      type: object
                  type: object
      summary: List OpenGov referenda
      tags:
      - Governance
      x-synonyms:
      - referenda
      - governance
      - scan
      - referendums
      - referendum
      - vote
      - treasury
      - council
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/internal_server_http.referendumsV2Params'
        description: params
        required: true
  /api/scan/referenda/statistics:
    post:
      description: 'Returns aggregated referendum statistics for supported democracy or referenda networks.

        This API only supports networks with referenda/democracy frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      $ref: '#/components/schemas/subscan_internal_model.ReferendumStatisticsJson'
                  type: object
      summary: Get referendum statistics
      tags:
      - Governance
      x-synonyms:
      - referendum
      - statistics
      - governance
      - scan
      - referenda
      - vote
      - treasury
      - council
  /api/scan/referenda/tracks:
    post:
      description: 'Returns the available referendum tracks for the current OpenGov network.

        This API only supports networks with referenda frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      additionalProperties:
                        $ref: '#/components/schemas/subscan_libs_substrate_storage.ReferendumTracksInfo'
                      type: object
                  type: object
      summary: List referendum tracks
      tags:
      - Governance
      x-synonyms:
      - referendum
      - tracks
      - governance
      - scan
      - referenda
      - vote
      - treasury
      - council
  /api/scan/referenda/votes:
    post:
      description: 'Returns paginated vote records for an OpenGov referendum or account.

        This API only supports networks with referenda frame'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/internal_server_http.J'
                - properties:
                    data:
                      properties:
                        count:
                          type: integer
                        list:
                          items:
                            $ref: '#/components/schemas/subscan_internal_model.ConvictionVoteJson'
                          type: array
                      type: object
                  type: object
      summary: List OpenGov referendum votes
      tags

# --- truncated at 32 KB (92 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/polkadot/refs/heads/main/openapi/polkadot-governance-api-openapi.yml