{"openapi":"3.1.0","info":{"title":"Internet Computer NNS Governance API","version":"1.0.0","description":"Internet Computer NNS (Network Nervous System) governance, live from the official public dashboard API — no key, nothing cached. The NNS is the on-chain DAO that controls the entire Internet Computer: ICP holders lock tokens into neurons and vote on proposals across topics — protocol upgrades, network economics, node administration, canister management, SNS launches and more. The base Internet Computer reader covers network, accounts, canisters and subnets, but not governance; this opens it. List NNS proposals filtered by topic and status, each with its title, proposer neuron, voting deadline and yes / no voting-power tally with percentages. Read a single proposal in full — its tally, action, status and decision timestamps. And get a live governance overview: the all-time total proposal count, how many are currently open for voting, and the breakdown of recent proposals by topic and status. The on-chain governance layer for Internet Computer wallets, neuron dashboards, voters and analytics. Live from ic-api.internetcomputer.org.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/icpgov-api","description":"oanor gateway"}],"tags":[{"name":"Proposals"},{"name":"Stats"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/proposal":{"get":{"operationId":"get_v1_proposal","tags":["Proposals"],"summary":"One proposal in full: tally, action, timestamps","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Proposal id (omit for the latest)","schema":{"type":"string"},"example":"142271"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"A single NNS proposal in full: its topic, status, action, yes/no voting-power tally and decision timestamps. Omit id for the most recent proposal.","tally":{"no":"4288621880057194","yes":"2536171913598928","total":"79254053608670910","no_pct":5.41,"yes_pct":3.2},"title":"Upgrade the Engine-controller Canister to Commit 6c4d31d","topic":"Application Canister Management","action":"InstallCode","source":"Internet Computer dashboard","status":"OPEN","summary":"# Upgrade the Engine-controller Canister to Commit 6c4d31d\n\n__Proposer__: pietro.di.marco at dfinity.org\n\n__Source code__: [6c4d31d69969a57e78cd17c237637592dd4fd960][new-commit]\n\n[new-commit]: https://github.com/dfinity/ic/tree/6c4d31d69969a57e78cd17c237637592dd4fd960\n\n\n## Features & Fixes\n\n* Allow the engine-controller canister to update cloud engines directly (#10431).\n* Return the newly created subnet id directly in the subnet-creation response. Callers no longer need to poll and match nodes to subnets after creation.\n* Extract the engine-controller canister's interface types into a shared, importable crate so other projects can depend on them (#10417).\n\n\n## New Commits\n\n```\n$ git log --format=\"%C(auto) %h %s\" c8649149f75040378e608e2a77eb3433122e7bf9..6c4d31d69969a57e78cd17c237637592dd4fd960 --  ./rs/engine_controller\n 8facd5635c feat: allow engine-controller canister to update cloud engines directly (#10431)\n ed411fe09d chore: extract types into a shared libary for engine-controlle","topic_raw":"TOPIC_APPLICATION_CANISTER_MANAGEMENT","proposal_id":142271,"reward_status":"ACCEPT_VOTES","proposer_neuron":"77","deadline_timestamp_seconds":1781689687},"meta":{"timestamp":"2026-06-14T08:03:44.409Z","request_id":"7155524b-493c-4a99-afe9-3ecf17672fba"},"status":"ok","message":"Proposal retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/proposals":{"get":{"operationId":"get_v1_proposals","tags":["Proposals"],"summary":"NNS proposals with tally, filterable by topic & status","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Page size (1-100)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Offset","schema":{"type":"string"},"example":"0"},{"name":"topic","in":"query","required":false,"description":"Topic filter (e.g. GOVERNANCE, NETWORK_ECONOMICS)","schema":{"type":"string"},"example":"GOVERNANCE"},{"name":"status","in":"query","required":false,"description":"OPEN / EXECUTED / REJECTED / ADOPTED","schema":{"type":"string"},"example":"OPEN"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Internet Computer NNS governance proposals (newest first), each with its topic, status, proposer neuron, voting deadline and yes/no voting-power tally. Filter with topic (e.g. GOVERNANCE, NETWORK_ECONOMICS) and status (OPEN/EXECUTED/REJECTED/ADOPTED).","count":0,"topic":"Governance","offset":0,"source":"Internet Computer dashboard","status":"OPEN","proposals":[],"total_proposals":0},"meta":{"timestamp":"2026-06-14T08:03:44.680Z","request_id":"2f0be55b-5808-44c6-a884-6812e6d17bbc"},"status":"ok","message":"Proposals retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/stats":{"get":{"operationId":"get_v1_stats","tags":["Stats"],"summary":"Live governance overview: totals, open count, breakdown by topic & status","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Live NNS governance overview: the all-time total proposal count, plus how the most recent proposals break down by topic and status (and how many are currently open for voting).","source":"Internet Computer dashboard","by_topic":{"Neuron Management":9,"Subnet Management":3,"Ic Os Version Election":4,"Ic Os Version Deployment":76,"Protocol Canister Management":3,"Application Canister Management":5},"by_status":{"OPEN":12,"EXECUTED":88},"sample_window":100,"open_in_window":12,"total_proposals":122261},"meta":{"timestamp":"2026-06-14T08:03:45.235Z","request_id":"5530572f-9c04-486a-af5a-0f07ce429e75"},"status":"ok","message":"Stats retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sample":{"open_in_window":12,"total_proposals":122261},"source":"official Internet Computer dashboard API (ic-api.internetcomputer.org), keyless","service":"icpgov-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/stats":"Live governance overview: totals, open count, breakdown by topic & status.","GET /v1/proposal":"One proposal in full: tally, action, timestamps (id; omit for latest).","GET /v1/proposals":"NNS proposals with tally, filterable by topic & status (limit, offset, topic, status)."},"description":"Read Internet Computer NNS (Network Nervous System) governance live from the official public dashboard API: list proposals filtered by topic and status with their voting-power tally, read a single proposal in full, and get a live governance overview (total proposals, open count, breakdown by topic/status). The on-chain governance layer for Internet Computer wallets, neuron dashboards and voters. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:03:45.300Z","request_id":"13a7ba4e-a843-4dab-a83e-442098af95b1"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":7700,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":940,"monthly_call_quota":142000,"rps_limit":9,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3320,"monthly_call_quota":788000,"rps_limit":22,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":9550,"monthly_call_quota":5300000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/icpgov-api"}