How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Polkadot

Polkadot Governance API

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

Documentation Provider Profile APIs.io OpenAPI GitHub

Polkadot Governance API is one of 57 APIs that Polkadot publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Governance. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, rate-limit docs, and a GitHub repository.

This API exposes 40 operations across 40 paths, and defines 91 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against a single base URL, https://https://www.subscan.io/.

40 operations 40 paths 91 schemas 40 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://polkadot.api.subscan.io
Contact
API Support
License
Apache 2.0
Terms of Service
View terms
Resource Areas
1

Paths & Operations 40

Across 40 paths, the API surfaces 40 operations — 40 POST. Each is listed below with its method, path, parameters, and response codes.

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

Schemas 91

The contract defines 91 schemas that model the data the API accepts and returns. The most detailed are subscan_internal_model.ReferendumV2Json (31 properties), subscan_internal_model.TreasuryCouncilCollectiveProposalDetailsJson (20 properties), subscan_internal_model.CouncilProposalJson (18 properties), subscan_internal_model.TechcommProposalJson (18 properties). Each schema is shown below with its type and property counts.

internal_server_http.councilProposalParams
object
1 property
internal_server_http.referendumDelegateDetailsParams
object
2 properties 1 required
internal_server_http.fellowshipReferendumParams
object
1 property
subscan_internal_model.CouncilVoteJson
object
5 properties
subscan_internal_model.DemocracyVoteJson
object
11 properties
subscan_internal_model.ChildBountySampleJson
object
7 properties
subscan_libs_opengovResource.PostComment
object
8 properties
subscan_internal_model.TreasuryCouncilCollectiveProposalJson
object
14 properties
subscan_internal_model.ReferendumV2SampleJson
object
14 properties
internal_server_http.treasuryProposalsParams
object
2 properties
subscan_internal_model.DemocracyJson
object
13 properties
subscan_internal_model.EvmAccountDisplay
object
2 properties
internal_server_http.democracyParams
object
1 property
subscan_internal_model.BountyJson
object
15 properties
internal_server_http.treasuryTipsParams
object
2 properties
subscan_internal_model.DemocracyReferendumSampleJson
object
10 properties
subscan_internal_model.ConvictionDelegateSum
object
4 properties
internal_server_http.accountReferendumParams
object
4 properties 1 required
subscan_internal_model.ReferendumJson
object
17 properties
subscan_libs_substrate_storage.LinearDecreasing
object
3 properties
internal_server_http.treasuryProposalParams
object
1 property
subscan_libs_substrate_storage.Reciprocal
object
3 properties
subscan_internal_model.TreasurySpend
object
8 properties
internal_server_http.J
object
4 properties
internal_server_http.treasuryTipperParams
object
1 property
subscan_internal_model.AccountParentJson
object
4 properties
subscan_internal_model.PreimageLinkJson
object
2 properties
subscan_libs_substrate_storage.ReferendumTracksInfo
object
10 properties
subscan_internal_model.DemocracyProposalSeconded
object
6 properties
subscan_internal_model.AccountDisplay
object
10 properties
subscan_internal_model.ReferendumV2Json
object
31 properties
subscan_internal_model.RegistrationJudgementJson
object
2 properties
subscan_internal_model.TreasuryTipJson
object
12 properties
subscan_internal_model.ExtrinsicParam
object
4 properties
internal_server_http.democracySecondedParams
object
3 properties
subscan_internal_model.ReferendumStatisticsOriginsJson
object
3 properties
internal_server_http.fellowshipReferendumVotesParams
object
3 properties
subscan_internal_model.TechcommProposalJson
object
18 properties
subscan_libs_opengovResource.PostData
object
6 properties
internal_server_http.democraciesParams
object
4 properties
subscan_internal_model.PreimageJson
object
13 properties
internal_server_http.bountiesParams
object
3 properties
internal_server_http.techcommProposalsParams
object
2 properties
subscan_libs_substrate_storage.SteppedDecreasing
object
4 properties
internal_server_http.referendumDelegateParams
object
8 properties 1 required
internal_server_http.referendumsParams
object
3 properties
subscan_internal_model.MerkleTag
object
4 properties
subscan_internal_model.TreasuryProposalDetailJson
object
13 properties
subscan_internal_model.ReferendumDelegateJson
object
7 properties
subscan_internal_model.ReferendumDelegateDetailsJson
object
6 properties
subscan_internal_model.ReferendumStatisticsJson
object
6 properties
subscan_internal_model.TreasurySpendProposalDetailJson
object
13 properties
internal_server_http.governanceDescParam
object
2 properties 2 required
subscan_internal_model.FellowshipReferendumStatisticsJson
object
6 properties
subscan_internal_model.ConvictionVoteJson
object
12 properties
subscan_internal_model.TreasurySpendProposalJson
object
9 properties
internal_server_http.treasuryCouncilCollectiveProposalsParam
object
2 properties
subscan_internal_model.ConvictionDelegateVoteJson
object
10 properties
subscan_internal_model.CouncilJson
object
9 properties
subscan_internal_model.TreasuryCouncilCollectiveProposalDetailsJson
object
20 properties
internal_server_http.childBountiesParams
object
3 properties
internal_server_http.treasuryTipParams
object
1 property
internal_server_http.referendumsV2Params
object
8 properties
internal_server_http.referendumVotesParams
object
8 properties
subscan_internal_model.PreImageJson
object
10 properties
internal_server_http.fellowshipReferendumsV2Params
object
7 properties
internal_server_http.referendumDelegateVotesParams
object
8 properties 1 required
subscan_internal_model.DemocracySampleJson
object
8 properties
subscan_internal_model.PreimageSampleJson
object
9 properties
subscan_internal_model.TechcommProposalSample
object
10 properties
subscan_internal_model.TreasuryTip
object
11 properties
internal_server_http.techcommProposalParams
object
1 property
internal_server_http.preimageDetailsParams
object
1 property 1 required
internal_server_http.treasuryCouncilCollectiveProposalParam
object
2 properties
subscan_internal_model.TimelineJson
object
7 properties
internal_server_http.treasuryCouncilCollectiveVotesParam
object
4 properties
subscan_internal_model.CouncilProposalJson
object
18 properties
internal_server_http.referendumV2Params
object
1 property
subscan_internal_model.TechcommVoteJson
object
5 properties
subscan_internal_model.AccountReferendumJson
object
3 properties
internal_server_http.referendumParams
object
1 property
subscan_libs_substrate_storage.ReferendaCurve
object
3 properties
subscan_internal_model.BountySampleJson
object
9 properties
internal_server_http.bountyParams
object
1 property
subscan_internal_model.SampleIdentity
object
4 properties
subscan_internal_model.TreasuryTipperJson
object
3 properties
internal_server_http.referendaVotesV2Params
object
8 properties
internal_server_http.preimageListParams
object
4 properties
internal_server_http.councilProposalsParams
object
2 properties
subscan_internal_model.TreasuryCouncilCollectiveVoteJson
object
7 properties
subscan_internal_model.TreasuryProposalJson
object
9 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

polkadot-governance-api-openapi.yml Raw ↑

Other APIs Polkadot publishes across the network.

Polkadot Account API
AE Profile APIs.io
Polkadot accounts API
AE Profile APIs.io
Polkadot ahm API
AE Profile APIs.io
Polkadot Assets API
AE Profile APIs.io
Polkadot Avail API
AE Profile APIs.io
Polkadot Bifrost API
AE Profile APIs.io
Polkadot Block API
AE Profile APIs.io
Polkadot blocks API
AE Profile APIs.io
Polkadot capabilities API
AE Profile APIs.io
Polkadot Collator API
AE Profile APIs.io
Polkadot Common API
AE Profile APIs.io
Polkadot Contracts API
AE Profile APIs.io
#Governance
← Back to P APIs
API Details
ID
polkadot:polkadot-governance-api
Base URL
https://polkadot.api.subscan.io
Docs
https://support.subscan.io/
Provider
Polkadot
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=polkadot-governance-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/polkadot-governance-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

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

Where this information came from

This is an independent, third-party profile of Polkadot Governance API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.