{ "item": [ { "name": "health", "description": "", "item": [ { "id": "6045ce65-fc40-45af-a772-fb3ed5d99833", "name": "v1 version + liveness probe", "request": { "name": "v1 version + liveness probe", "description": {}, "url": { "path": [ "health" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "ebb56dc1-4dc3-4214-92fd-9c4592f229b0", "name": "OK", "originalRequest": { "url": { "path": [ "health" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"version\": \"\",\n \"status\": \"\",\n \"timestamp\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "config", "description": "", "item": [ { "id": "f1c9d862-5d82-48e4-b00f-d894d5185099", "name": "Deployment runtime config (explorer + IPFS gateway + network)", "request": { "name": "Deployment runtime config (explorer + IPFS gateway + network)", "description": { "content": "Public, unauthenticated. Frontends and third-party integrators read\nthis to render explorer / IPFS links without hardcoding a network.\nEach instance returns its own configured values; safe defaults are\nused when the deployment hasn't overridden them.\n", "type": "text/plain" }, "url": { "path": [ "config" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "0f9cdb48-fef4-4752-9557-62390142fba2", "name": "OK", "originalRequest": { "url": { "path": [ "config" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"ipfsGatewayBase\": \"\",\n \"explorerTxBase\": \"\",\n \"explorerAddressBase\": \"\",\n \"network\": \"mainnet\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "ballots", "description": "", "item": [ { "id": "953b9144-980a-40ab-ae19-84bc1107b9fa", "name": "List ballots across all sources", "request": { "name": "List ballots across all sources", "description": { "content": "`Cache-Control: public, max-age=60`. Ballot definitions are largely\nstatic once published; poll **/results** separately for live tallies.\n", "type": "text/plain" }, "url": { "path": [ "ballots" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "voterType", "value": "" }, { "disabled": false, "description": { "content": " (This can only be one of upcoming,live,closed)", "type": "text/plain" }, "key": "status", "value": "upcoming" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Restrict to a single adapter (`legacy` or `hydra`). (This can only be one of legacy,hydra)", "type": "text/plain" }, "key": "source", "value": "hydra" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "e3fd3d6b-dc3b-4220-848b-6cc94d770333", "name": "Paginated list", "originalRequest": { "url": { "path": [ "ballots" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "voterType", "value": "" }, { "disabled": false, "description": { "content": " (This can only be one of upcoming,live,closed)", "type": "text/plain" }, "key": "status", "value": "upcoming" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "search", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "10" }, { "disabled": false, "description": { "content": "Restrict to a single adapter (`legacy` or `hydra`). (This can only be one of legacy,hydra)", "type": "text/plain" }, "key": "source", "value": "hydra" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"\",\n \"source\": \"hydra\",\n \"title\": \"\",\n \"description\": \"\",\n \"status\": \"upcoming\",\n \"voterType\": \"\",\n \"voterGroups\": [\n {\n \"group\": \"stake\",\n \"powerSource\": \"StakeBased\"\n },\n {\n \"group\": \"drep\",\n \"powerSource\": \"CredentialBased\"\n }\n ],\n \"voterDescription\": \"\",\n \"voteWeighted\": \"\",\n \"votePeriodStart\": \"\",\n \"votePeriodEnd\": \"\",\n \"voteFilters\": \"\",\n \"ipfsHash\": \"\",\n \"proposalCount\": \"\",\n \"singleProposal\": \"\",\n \"hydra\": {\n \"endpoint\": \"\",\n \"headId\": \"\",\n \"ballotCid\": \"\",\n \"instancePolicyId\": \"\",\n \"headInfo\": {},\n \"ballot\": {}\n },\n \"provisionalResultsEnabled\": \"\",\n \"proposalSource\": {\n \"moduleId\": \"\",\n \"moduleUrl\": \"\",\n \"externalBallotId\": \"\",\n \"version\": \"\",\n \"importedAt\": \"\",\n \"importMethod\": \"upload\",\n \"importedBy\": \"\"\n },\n \"facets\": [\n {\n \"key\": \"AimZ8D_C2ij\",\n \"label\": \"\",\n \"type\": \"date\",\n \"multi\": false,\n \"options\": [\n \"\",\n \"\"\n ],\n \"unit\": \"\",\n \"sortable\": false,\n \"filterable\": true,\n \"defaultSort\": \"asc\"\n },\n {\n \"key\": \"EM\",\n \"label\": \"\",\n \"type\": \"date\",\n \"multi\": false,\n \"options\": [\n \"\",\n \"\"\n ],\n \"unit\": \"\",\n \"sortable\": false,\n \"filterable\": true,\n \"defaultSort\": \"desc\"\n }\n ],\n \"createdAt\": \"\",\n \"updatedAt\": \"\"\n },\n {\n \"id\": \"\",\n \"source\": \"hydra\",\n \"title\": \"\",\n \"description\": \"\",\n \"status\": \"upcoming\",\n \"voterType\": \"\",\n \"voterGroups\": [\n {\n \"group\": \"stake\",\n \"powerSource\": \"StakeBased\"\n },\n {\n \"group\": \"pool\",\n \"powerSource\": \"StakeBased\"\n }\n ],\n \"voterDescription\": \"\",\n \"voteWeighted\": \"\",\n \"votePeriodStart\": \"\",\n \"votePeriodEnd\": \"\",\n \"voteFilters\": \"\",\n \"ipfsHash\": \"\",\n \"proposalCount\": \"\",\n \"singleProposal\": \"\",\n \"hydra\": {\n \"endpoint\": \"\",\n \"headId\": \"\",\n \"ballotCid\": \"\",\n \"instancePolicyId\": \"\",\n \"headInfo\": {},\n \"ballot\": {}\n },\n \"provisionalResultsEnabled\": \"\",\n \"proposalSource\": {\n \"moduleId\": \"\",\n \"moduleUrl\": \"\",\n \"externalBallotId\": \"\",\n \"version\": \"\",\n \"importedAt\": \"\",\n \"importMethod\": \"upload\",\n \"importedBy\": \"\"\n },\n \"facets\": [\n {\n \"key\": \"0R\",\n \"label\": \"\",\n \"type\": \"enum\",\n \"multi\": false,\n \"options\": [\n \"\",\n \"\"\n ],\n \"unit\": \"\",\n \"sortable\": false,\n \"filterable\": true,\n \"defaultSort\": \"desc\"\n },\n {\n \"key\": \"-fy6iZ\",\n \"label\": \"\",\n \"type\": \"boolean\",\n \"multi\": false,\n \"options\": [\n \"\",\n \"\"\n ],\n \"unit\": \"\",\n \"sortable\": false,\n \"filterable\": true,\n \"defaultSort\": \"asc\"\n }\n ],\n \"createdAt\": \"\",\n \"updatedAt\": \"\"\n }\n ],\n \"pagination\": {\n \"total\": \"\",\n \"page\": \"\",\n \"limit\": \"\",\n \"totalPages\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{id}", "description": "", "item": [ { "id": "d48ca785-004d-42a2-86a3-582fcbaba54d", "name": "Ballot detail (enriched from Hydra when source === \"hydra\")", "request": { "name": "Ballot detail (enriched from Hydra when source === \"hydra\")", "description": { "content": "Cache-Control varies by status: `closed` → `max-age=3600`, `live` →\n`max-age=120`, `upcoming` → `max-age=30`. Results are **not** embedded —\ncall `/results/ballot/{id}` separately.\n", "type": "text/plain" }, "url": { "path": [ "ballots", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "6fec0ed7-aa7a-49d5-ac43-9563fcae1fc9", "name": "Ballot", "originalRequest": { "url": { "path": [ "ballots", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"id\": \"\",\n \"source\": \"legacy\",\n \"title\": \"\",\n \"description\": \"\",\n \"status\": \"live\",\n \"voterType\": \"\",\n \"voterGroups\": [\n {\n \"group\": \"stake\",\n \"powerSource\": \"PledgeBased\"\n },\n {\n \"group\": \"drep\",\n \"powerSource\": \"PledgeBased\"\n }\n ],\n \"voterDescription\": \"\",\n \"voteWeighted\": \"\",\n \"votePeriodStart\": \"\",\n \"votePeriodEnd\": \"\",\n \"voteFilters\": \"\",\n \"ipfsHash\": \"\",\n \"proposalCount\": \"\",\n \"singleProposal\": \"\",\n \"hydra\": {\n \"endpoint\": \"\",\n \"headId\": \"\",\n \"ballotCid\": \"\",\n \"instancePolicyId\": \"\",\n \"headInfo\": {},\n \"ballot\": {}\n },\n \"provisionalResultsEnabled\": \"\",\n \"proposalSource\": {\n \"moduleId\": \"\",\n \"moduleUrl\": \"\",\n \"externalBallotId\": \"\",\n \"version\": \"\",\n \"importedAt\": \"\",\n \"importMethod\": \"push\",\n \"importedBy\": \"\"\n },\n \"facets\": [\n {\n \"key\": \"IMzB\",\n \"label\": \"\",\n \"type\": \"boolean\",\n \"multi\": false,\n \"options\": [\n \"\",\n \"\"\n ],\n \"unit\": \"\",\n \"sortable\": false,\n \"filterable\": true,\n \"defaultSort\": \"asc\"\n },\n {\n \"key\": \"dr66GTW21V\",\n \"label\": \"\",\n \"type\": \"number\",\n \"multi\": false,\n \"options\": [\n \"\",\n \"\"\n ],\n \"unit\": \"\",\n \"sortable\": false,\n \"filterable\": true,\n \"defaultSort\": \"asc\"\n }\n ],\n \"createdAt\": \"\",\n \"updatedAt\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "88f99894-4c2e-44b9-84a0-268188031ddd", "name": "Not found", "originalRequest": { "url": { "path": [ "ballots", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "questions", "description": "", "item": [ { "name": "{qid}", "description": "", "item": [ { "name": "content", "description": "", "item": [ { "id": "e8210b85-7e77-4f5a-96a9-7f28277ac9d0", "name": "Per-proposal canonical content bytes (audit chain-of-custody)", "request": { "name": "Per-proposal canonical content bytes (audit chain-of-custody)", "description": { "content": "Returns the byte-identical canonical JSON that `Proposal.contentHash`\nwas computed over. Auditors re-hash these bytes with `blake2b_256` to\nverify the proposal hasn't drifted since ballot-prepare time.\n\nPublic, unauthenticated by design — long-term auditability requires\nno gate. The chain of custody is:\n\n on-chain (600) datum → ekklesia.merkleRoot\n → IPFS-pinned ballot JSON (covers BallotQuestion.contentHash[n])\n → per-proposal content blob (this endpoint).\n\nCache-Control mirrors `/ballots/{id}` and varies by ballot status.\n", "type": "text/plain" }, "url": { "path": [ "ballots", ":id", "questions", ":qid", "content" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } }, { "type": "any", "value": "", "key": "qid", "disabled": false, "description": { "content": "(Required) Proposal id (must belong to the ballot).", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "9c56b661-32e0-425e-94df-2ad1191be451", "name": "Canonical content bytes", "originalRequest": { "url": { "path": [ "ballots", ":id", "questions", ":qid", "content" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" }, { "disabled": false, "description": { "content": "(Required) Proposal id (must belong to the ballot).", "type": "text/plain" }, "type": "any", "value": "", "key": "qid" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4a1ea4a2-8d45-45c0-8712-20882a980c24", "name": "Ballot or proposal not found", "originalRequest": { "url": { "path": [ "ballots", ":id", "questions", ":qid", "content" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" }, { "disabled": false, "description": { "content": "(Required) Proposal id (must belong to the ballot).", "type": "text/plain" }, "type": "any", "value": "", "key": "qid" } ] }, "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ] }, { "name": "archive", "description": "", "item": [ { "id": "b9a103c1-af5e-400b-b365-1afab6d41992", "name": "Full audit bundle (ballot + proposals + manifest + README)", "request": { "name": "Full audit bundle (ballot + proposals + manifest + README)", "description": { "content": "One JSON file carrying every voter-facing committed field, a\nper-file hash MANIFEST (blake2b_256 + sha256), and a README with\nthe verification recipe. Designed to be saved to disk and re-pinned\nto IPFS by anyone who cares about long-term audit. Public,\nunauthenticated.\n\nThe response is served with `Content-Disposition: attachment` so\nbrowsers download instead of preview.\n", "type": "text/plain" }, "url": { "path": [ "ballots", ":id", "archive" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "d5d46870-1574-4b67-b34b-977bd1487ff2", "name": "Audit bundle", "originalRequest": { "url": { "path": [ "ballots", ":id", "archive" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"schemaVersion\": \"\",\n \"generatedAt\": \"\",\n \"ballot\": {},\n \"proposals\": {\n \"key_0\": {},\n \"key_1\": {}\n },\n \"manifest\": [\n {\n \"path\": \"\",\n \"bytes\": \"\",\n \"blake2b_256\": \"\",\n \"sha256\": \"\"\n },\n {\n \"path\": \"\",\n \"bytes\": \"\",\n \"blake2b_256\": \"\",\n \"sha256\": \"\"\n }\n ],\n \"readme\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aa20ab0a-ce8d-4bd9-9737-6e417e3942fb", "name": "Ballot not found", "originalRequest": { "url": { "path": [ "ballots", ":id", "archive" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "certified", "description": "", "item": [ { "id": "f54c99b4-4940-49b3-a1be-4ac8df715f1f", "name": "Authority certification state + version history", "request": { "name": "Authority certification state + version history", "description": { "content": "Surfaces the currently-active `CertifiedSnapshot` (if any) plus the\nfull version history so the frontend can label results as\n\"Certified at version N by \" vs. \"Provisional\n(Hydra-final, not yet certified)\".\n\n- `certified: true` → an authority snapshot is active; full\n shape includes per-proposal tallies and snapshot metadata.\n- `certified: false` → no active certification. `narrative` may\n still be set if a narrative-only publication exists.\n", "type": "text/plain" }, "url": { "path": [ "ballots", ":id", "certified" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "9230d98e-df85-4d6d-b985-aea14bb4ff53", "name": "Certification state", "originalRequest": { "url": { "path": [ "ballots", ":id", "certified" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"data\": {\n \"certified\": false,\n \"history\": [\n {\n \"version\": \"\",\n \"submittedAt\": \"\",\n \"submittedBy\": \"\",\n \"source\": \"\",\n \"chainTxHash\": \"\",\n \"snapshotUrl\": \"\",\n \"snapshotHash\": \"\",\n \"narrativeOnly\": \"\",\n \"narrative\": {\n \"url\": \"\",\n \"label\": \"\"\n }\n },\n {\n \"version\": \"\",\n \"submittedAt\": \"\",\n \"submittedBy\": \"\",\n \"source\": \"\",\n \"chainTxHash\": \"\",\n \"snapshotUrl\": \"\",\n \"snapshotHash\": \"\",\n \"narrativeOnly\": \"\",\n \"narrative\": {\n \"url\": \"\",\n \"label\": \"\"\n }\n }\n ],\n \"narrative\": {\n \"url\": \"\",\n \"label\": \"\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3d669ec9-908b-4c98-bf36-f0df66502758", "name": "Ballot not found", "originalRequest": { "url": { "path": [ "ballots", ":id", "certified" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ] }, { "name": "results", "description": "", "item": [ { "name": "ballot", "description": "", "item": [ { "name": "{ballotId}", "description": "", "item": [ { "id": "6ddb9555-ccb8-43e7-8864-81e42e857400", "name": "All Result rows for a ballot — anonymous, short-cached", "request": { "name": "All Result rows for a ballot — anonymous, short-cached", "description": { "content": "Served with `Cache-Control: public, max-age=30` so clients can poll\ncheaply while provisional tallies are refreshed periodically (roughly\nevery 10 minutes). Final tallies land the moment the voting authority\nfinalizes the ballot.\n", "type": "text/plain" }, "url": { "path": [ "results", "ballot", ":ballotId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "ballotId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "45f79b8b-9164-41ae-bcf5-de3d4b5cded0", "name": "Array of Result rows", "originalRequest": { "url": { "path": [ "results", "ballot", ":ballotId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"proposalId\": \"\",\n \"ballotId\": \"\",\n \"source\": \"final\",\n \"ballotSource\": \"legacy\",\n \"finalizedAt\": \"\",\n \"hydraEvidenceCid\": \"\",\n \"hydraResultsCid\": \"\",\n \"hydraFinalizeTxHash\": \"\",\n \"hydraResultsHash\": \"\",\n \"hydraEvidenceMerkleRoot\": \"\",\n \"hydraTotalVoters\": \"\",\n \"hydraExcludedVoters\": [\n {\n \"tokenName\": \"\",\n \"reason\": \"\"\n },\n {\n \"tokenName\": \"\",\n \"reason\": \"\"\n }\n ],\n \"results\": [\n {\n \"id\": \"\",\n \"label\": \"\",\n \"count\": \"\",\n \"votingPower\": \"\"\n },\n {\n \"id\": \"\",\n \"label\": \"\",\n \"count\": \"\",\n \"votingPower\": \"\"\n }\n ],\n \"resultsByGroup\": {}\n },\n {\n \"proposalId\": \"\",\n \"ballotId\": \"\",\n \"source\": \"provisional\",\n \"ballotSource\": \"hydra\",\n \"finalizedAt\": \"\",\n \"hydraEvidenceCid\": \"\",\n \"hydraResultsCid\": \"\",\n \"hydraFinalizeTxHash\": \"\",\n \"hydraResultsHash\": \"\",\n \"hydraEvidenceMerkleRoot\": \"\",\n \"hydraTotalVoters\": \"\",\n \"hydraExcludedVoters\": [\n {\n \"tokenName\": \"\",\n \"reason\": \"\"\n },\n {\n \"tokenName\": \"\",\n \"reason\": \"\"\n }\n ],\n \"results\": [\n {\n \"id\": \"\",\n \"label\": \"\",\n \"count\": \"\",\n \"votingPower\": \"\"\n },\n {\n \"id\": \"\",\n \"label\": \"\",\n \"count\": \"\",\n \"votingPower\": \"\"\n }\n ],\n \"resultsByGroup\": {}\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "proposal", "description": "", "item": [ { "name": "{proposalId}", "description": "", "item": [ { "id": "12030561-72ba-4b2c-bcfc-523b76cd429f", "name": "Single proposal result — anonymous, short-cached", "request": { "name": "Single proposal result — anonymous, short-cached", "description": {}, "url": { "path": [ "results", "proposal", ":proposalId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "proposalId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "d08d358a-8509-412d-bc56-d10f1e0d5ea8", "name": "OK", "originalRequest": { "url": { "path": [ "results", "proposal", ":proposalId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "proposalId" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"proposalId\": \"\",\n \"ballotId\": \"\",\n \"source\": \"provisional\",\n \"ballotSource\": \"hydra\",\n \"finalizedAt\": \"\",\n \"hydraEvidenceCid\": \"\",\n \"hydraResultsCid\": \"\",\n \"hydraFinalizeTxHash\": \"\",\n \"hydraResultsHash\": \"\",\n \"hydraEvidenceMerkleRoot\": \"\",\n \"hydraTotalVoters\": \"\",\n \"hydraExcludedVoters\": [\n {\n \"tokenName\": \"\",\n \"reason\": \"\"\n },\n {\n \"tokenName\": \"\",\n \"reason\": \"\"\n }\n ],\n \"results\": [\n {\n \"id\": \"\",\n \"label\": \"\",\n \"count\": \"\",\n \"votingPower\": \"\"\n },\n {\n \"id\": \"\",\n \"label\": \"\",\n \"count\": \"\",\n \"votingPower\": \"\"\n }\n ],\n \"resultsByGroup\": {}\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6295d380-aecd-4b10-8319-4b9d6c22e48f", "name": "No results yet", "originalRequest": { "url": { "path": [ "results", "proposal", ":proposalId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "proposalId" } ] }, "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ] }, { "name": "votes", "description": "", "item": [ { "name": "{ballotId}", "description": "", "item": [ { "name": "draft", "description": "", "item": [ { "id": "7c3ef132-d807-40ff-905b-68b73730dec8", "name": "Create or resume a draft vote package (idempotent upsert)", "request": { "name": "Create or resume a draft vote package (idempotent upsert)", "description": { "content": "**Idempotent on (voter, ballot).** If the authenticated voter already\nhas a non-terminal VotePackage on this ballot, that package is\nreturned / updated in place — a fresh nonce is NOT reserved. Hydra\nrequires `signedPayload.nonce === currentVersion + 1` strictly, so\nburning a new nonce on every /draft click would drift the stored\nnonce ahead of Hydra's expected next value.\n\nBehavior:\n - No active package exists → reserves nonce, creates VotePackage,\n returns 201.\n - Active package exists with matching selections → returns the\n existing package unchanged (same packageId, same merkleRoot),\n status 200.\n - Active package exists with DIFFERENT selections AND no\n signatures collected → updates signingPayload + merkleRoot +\n voteHash in place; same packageId + nonce; status 200.\n - Active package exists with DIFFERENT selections AND signatures\n already collected (multisig partial) → 409\n `PACKAGE_ALREADY_SIGNED`. Voter must DELETE and redraft.\n\nAbandoning an in-flight package (DELETE endpoint or TTL sweep)\nreleases the nonce so the next fresh /draft reuses the same value.\n", "type": "text/plain" }, "url": { "path": [ "votes", ":ballotId", "draft" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "ballotId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"votes\": [\n {\n \"questionId\": \"\",\n \"selection\": [\n \"\",\n \"\"\n ],\n \"ranking\": [\n \"\",\n \"\"\n ],\n \"weights\": [\n {\n \"option\": \"\",\n \"weight\": \"\"\n },\n {\n \"option\": \"\",\n \"weight\": \"\"\n }\n ]\n },\n {\n \"questionId\": \"\",\n \"selection\": [\n \"\",\n \"\"\n ],\n \"ranking\": [\n \"\",\n \"\"\n ],\n \"weights\": [\n {\n \"option\": \"\",\n \"weight\": \"\"\n },\n {\n \"option\": \"\",\n \"weight\": \"\"\n }\n ]\n }\n ],\n \"nativeScript\": {},\n \"calidusDeclaration\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "token" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "2735c01c-3400-4031-8887-c48f2ad446f4", "name": "Existing active package returned or updated in place", "originalRequest": { "url": { "path": [ "votes", ":ballotId", "draft" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "token", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"votes\": [\n {\n \"questionId\": \"\",\n \"selection\": [\n \"\",\n \"\"\n ],\n \"ranking\": [\n \"\",\n \"\"\n ],\n \"weights\": [\n {\n \"option\": \"\",\n \"weight\": \"\"\n },\n {\n \"option\": \"\",\n \"weight\": \"\"\n }\n ]\n },\n {\n \"questionId\": \"\",\n \"selection\": [\n \"\",\n \"\"\n ],\n \"ranking\": [\n \"\",\n \"\"\n ],\n \"weights\": [\n {\n \"option\": \"\",\n \"weight\": \"\"\n },\n {\n \"option\": \"\",\n \"weight\": \"\"\n }\n ]\n }\n ],\n \"nativeScript\": {},\n \"calidusDeclaration\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"package\": {\n \"id\": \"\",\n \"status\": \"\",\n \"nonce\": \"\"\n },\n \"signingPayload\": {},\n \"signingPayloadHex\": \"\",\n \"merkleRoot\": \"\",\n \"signedPayloadJson\": \"\",\n \"prelimVoteHash\": \"\",\n \"multisig\": {\n \"required\": \"\",\n \"eligibleKeys\": [\n \"\",\n \"\"\n ],\n \"outstandingKeys\": [\n \"\",\n \"\"\n ],\n \"satisfied\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ef7c8a3d-7976-4c1e-94b8-a86b4fec3d1c", "name": "New draft created", "originalRequest": { "url": { "path": [ "votes", ":ballotId", "draft" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "token", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"votes\": [\n {\n \"questionId\": \"\",\n \"selection\": [\n \"\",\n \"\"\n ],\n \"ranking\": [\n \"\",\n \"\"\n ],\n \"weights\": [\n {\n \"option\": \"\",\n \"weight\": \"\"\n },\n {\n \"option\": \"\",\n \"weight\": \"\"\n }\n ]\n },\n {\n \"questionId\": \"\",\n \"selection\": [\n \"\",\n \"\"\n ],\n \"ranking\": [\n \"\",\n \"\"\n ],\n \"weights\": [\n {\n \"option\": \"\",\n \"weight\": \"\"\n },\n {\n \"option\": \"\",\n \"weight\": \"\"\n }\n ]\n }\n ],\n \"nativeScript\": {},\n \"calidusDeclaration\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"package\": {\n \"id\": \"\",\n \"status\": \"\",\n \"nonce\": \"\"\n },\n \"signingPayload\": {},\n \"signingPayloadHex\": \"\",\n \"merkleRoot\": \"\",\n \"signedPayloadJson\": \"\",\n \"prelimVoteHash\": \"\",\n \"multisig\": {\n \"required\": \"\",\n \"eligibleKeys\": [\n \"\",\n \"\"\n ],\n \"outstandingKeys\": [\n \"\",\n \"\"\n ],\n \"satisfied\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b2a55e72-058a-4468-82c3-732827a45690", "name": "Voter is not eligible", "originalRequest": { "url": { "path": [ "votes", ":ballotId", "draft" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "token", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"votes\": [\n {\n \"questionId\": \"\",\n \"selection\": [\n \"\",\n \"\"\n ],\n \"ranking\": [\n \"\",\n \"\"\n ],\n \"weights\": [\n {\n \"option\": \"\",\n \"weight\": \"\"\n },\n {\n \"option\": \"\",\n \"weight\": \"\"\n }\n ]\n },\n {\n \"questionId\": \"\",\n \"selection\": [\n \"\",\n \"\"\n ],\n \"ranking\": [\n \"\",\n \"\"\n ],\n \"weights\": [\n {\n \"option\": \"\",\n \"weight\": \"\"\n },\n {\n \"option\": \"\",\n \"weight\": \"\"\n }\n ]\n }\n ],\n \"nativeScript\": {},\n \"calidusDeclaration\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "39a5ee90-cd68-4549-bc97-fdaf2b187932", "name": "Package already has collected signatures; mutating selections\nwould invalidate cosigners. Call DELETE and redraft.", "originalRequest": { "url": { "path": [ "votes", ":ballotId", "draft" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "token", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"votes\": [\n {\n \"questionId\": \"\",\n \"selection\": [\n \"\",\n \"\"\n ],\n \"ranking\": [\n \"\",\n \"\"\n ],\n \"weights\": [\n {\n \"option\": \"\",\n \"weight\": \"\"\n },\n {\n \"option\": \"\",\n \"weight\": \"\"\n }\n ]\n },\n {\n \"questionId\": \"\",\n \"selection\": [\n \"\",\n \"\"\n ],\n \"ranking\": [\n \"\",\n \"\"\n ],\n \"weights\": [\n {\n \"option\": \"\",\n \"weight\": \"\"\n },\n {\n \"option\": \"\",\n \"weight\": \"\"\n }\n ]\n }\n ],\n \"nativeScript\": {},\n \"calidusDeclaration\": {}\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"error\",\n \"code\": \"PACKAGE_ALREADY_SIGNED\",\n \"message\": \"\",\n \"package\": {\n \"_id\": \"\",\n \"status\": \"draft\",\n \"nonce\": \"\",\n \"voteHash\": \"\",\n \"hydraTxId\": \"\",\n \"ipfsCid\": \"\",\n \"confirmedAt\": \"\",\n \"signatures\": [\n {\n \"key\": \"\",\n \"coseSign1Hex\": \"\",\n \"coseKeyHex\": \"\",\n \"signature\": \"\"\n },\n {\n \"key\": \"\",\n \"coseSign1Hex\": \"\",\n \"coseKeyHex\": \"\",\n \"signature\": \"\"\n }\n ],\n \"merkleRoot\": \"\",\n \"signingPayloadHex\": \"\",\n \"signedPayloadJson\": \"\",\n \"multisig\": {\n \"required\": \"\",\n \"eligibleKeys\": [\n \"\",\n \"\"\n ],\n \"outstandingKeys\": [\n \"\",\n \"\"\n ],\n \"satisfied\": \"\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "signature", "description": "", "item": [ { "id": "63cae4a0-ac6d-41b4-a94e-5ebb4bcac768", "name": "Append a signature; submits to Hydra when threshold is met", "request": { "name": "Append a signature; submits to Hydra when threshold is met", "description": {}, "url": { "path": [ "votes", ":ballotId", "signature" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "ballotId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"packageId\": \"\",\n \"witness\": {\n \"key\": \"\",\n \"coseSign1Hex\": \"\",\n \"coseKeyHex\": \"\",\n \"signature\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "token" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "b2ada3f2-1964-46dd-9a41-505532cebd79", "name": "Signature appended (and possibly submitted)", "originalRequest": { "url": { "path": [ "votes", ":ballotId", "signature" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "token", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"packageId\": \"\",\n \"witness\": {\n \"key\": \"\",\n \"coseSign1Hex\": \"\",\n \"coseKeyHex\": \"\",\n \"signature\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"submitted\": \"\",\n \"package\": {\n \"_id\": \"\",\n \"status\": \"failed\",\n \"nonce\": \"\",\n \"voteHash\": \"\",\n \"hydraTxId\": \"\",\n \"ipfsCid\": \"\",\n \"confirmedAt\": \"\",\n \"signatures\": [\n {\n \"key\": \"\",\n \"coseSign1Hex\": \"\",\n \"coseKeyHex\": \"\",\n \"signature\": \"\"\n },\n {\n \"key\": \"\",\n \"coseSign1Hex\": \"\",\n \"coseKeyHex\": \"\",\n \"signature\": \"\"\n }\n ],\n \"merkleRoot\": \"\",\n \"signingPayloadHex\": \"\",\n \"signedPayloadJson\": \"\",\n \"multisig\": {\n \"required\": \"\",\n \"eligibleKeys\": [\n \"\",\n \"\"\n ],\n \"outstandingKeys\": [\n \"\",\n \"\"\n ],\n \"satisfied\": \"\"\n }\n },\n \"multisig\": {\n \"required\": \"\",\n \"eligibleKeys\": [\n \"\",\n \"\"\n ],\n \"outstandingKeys\": [\n \"\",\n \"\"\n ],\n \"satisfied\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b3e71718-c191-43f1-833c-9a04cb5d16f4", "name": "Package in terminal state", "originalRequest": { "url": { "path": [ "votes", ":ballotId", "signature" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "token", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"packageId\": \"\",\n \"witness\": {\n \"key\": \"\",\n \"coseSign1Hex\": \"\",\n \"coseKeyHex\": \"\",\n \"signature\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "e37c709e-9d21-4fe2-be5f-a5c671f5c7b3", "name": "Hydra submission failed", "originalRequest": { "url": { "path": [ "votes", ":ballotId", "signature" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "token", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"packageId\": \"\",\n \"witness\": {\n \"key\": \"\",\n \"coseSign1Hex\": \"\",\n \"coseKeyHex\": \"\",\n \"signature\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "Bad Gateway", "code": 502, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "mine", "description": "", "item": [ { "id": "2470bd8a-7e24-41d8-a909-fa20ab62c267", "name": "Rehydrate voter's current state on this ballot", "request": { "name": "Rehydrate voter's current state on this ballot", "description": { "content": "**CRITICAL SEMANTIC**: Hydra treats every submitted vote payload as the\nvoter's COMPLETE final state — it does NOT merge with prior submissions.\nIf a voter previously voted on Proposals 2/3/4 and now submits a payload\ncontaining only Proposal 5, the Hydra head erases the 2/3/4 votes.\n\nTo amend or add votes, the frontend rehydrates from\n`confirmed.votes`, lets the user edit the selection set, then sends\nthe COMPLETE ballot to `/draft`. Whatever's in the votes array IS the\nfull final state — removing a prior vote is simply omitting it.\nThe backend does not merge; the frontend owns the composition.\n\n`confirmed` is the latest hydra-confirmed package (the on-chain source\nof truth). `inFlight` lists packages still awaiting signatures,\nsubmission, or that failed — when one of these submits it REPLACES the\nconfirmed state.\n", "type": "text/plain" }, "url": { "path": [ "votes", ":ballotId", "mine" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "ballotId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "token" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "51d2376e-be8a-4235-9fff-1cbdc81cbea9", "name": "Voter's per-ballot state", "originalRequest": { "url": { "path": [ "votes", ":ballotId", "mine" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "token", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"ballotId\": \"\",\n \"confirmed\": {\n \"packageId\": \"\",\n \"nonce\": \"\",\n \"submittedAt\": \"\",\n \"hydraTxId\": \"\",\n \"votes\": {\n \"key_0\": {\n \"selection\": [\n \"\",\n \"\"\n ]\n },\n \"key_1\": {\n \"selection\": [\n \"\",\n \"\"\n ]\n }\n }\n },\n \"inFlight\": [\n {\n \"packageId\": \"\",\n \"status\": \"awaiting-submission\",\n \"nonce\": \"\",\n \"createdAt\": \"\",\n \"votes\": {\n \"key_0\": {\n \"selection\": [\n \"\",\n \"\"\n ]\n }\n },\n \"multisig\": {\n \"signaturesCollected\": \"\",\n \"signaturesNeeded\": \"\",\n \"satisfied\": \"\"\n }\n },\n {\n \"packageId\": \"\",\n \"status\": \"awaiting-submission\",\n \"nonce\": \"\",\n \"createdAt\": \"\",\n \"votes\": {\n \"key_0\": {\n \"selection\": [\n \"\",\n \"\"\n ]\n },\n \"key_1\": {\n \"selection\": [\n \"\",\n \"\"\n ]\n },\n \"key_2\": {\n \"selection\": [\n \"\",\n \"\"\n ]\n }\n },\n \"multisig\": {\n \"signaturesCollected\": \"\",\n \"signaturesNeeded\": \"\",\n \"satisfied\": \"\"\n }\n }\n ],\n \"summary\": {\n \"confirmed\": \"\",\n \"awaitingSignatures\": \"\",\n \"awaitingSubmission\": \"\",\n \"draft\": \"\",\n \"failed\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "771c01f8-d69a-494d-9b36-68cc90bc5128", "name": "Auth required", "originalRequest": { "url": { "path": [ "votes", ":ballotId", "mine" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "token", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "022119bc-318c-478a-8b1c-54a8455ff0ba", "name": "Ballot not found or not Hydra-backed", "originalRequest": { "url": { "path": [ "votes", ":ballotId", "mine" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "token", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "submit", "description": "", "item": [ { "id": "939dee9e-89cb-46ee-8070-96087ebbe3a6", "name": "Manual retry of submission for a package in awaiting-submission", "request": { "name": "Manual retry of submission for a package in awaiting-submission", "description": {}, "url": { "path": [ "votes", ":ballotId", "submit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "ballotId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"packageId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "token" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "4444453e-588e-4ca8-a1bb-47a37a8b938d", "name": "Submission state", "originalRequest": { "url": { "path": [ "votes", ":ballotId", "submit" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "token", "value": "" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"packageId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"package\": {\n \"_id\": \"\",\n \"status\": \"broker-submitted\",\n \"nonce\": \"\",\n \"voteHash\": \"\",\n \"hydraTxId\": \"\",\n \"ipfsCid\": \"\",\n \"confirmedAt\": \"\",\n \"signatures\": [\n {\n \"key\": \"\",\n \"coseSign1Hex\": \"\",\n \"coseKeyHex\": \"\",\n \"signature\": \"\"\n },\n {\n \"key\": \"\",\n \"coseSign1Hex\": \"\",\n \"coseKeyHex\": \"\",\n \"signature\": \"\"\n }\n ],\n \"merkleRoot\": \"\",\n \"signingPayloadHex\": \"\",\n \"signedPayloadJson\": \"\",\n \"multisig\": {\n \"required\": \"\",\n \"eligibleKeys\": [\n \"\",\n \"\"\n ],\n \"outstandingKeys\": [\n \"\",\n \"\"\n ],\n \"satisfied\": \"\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "packages", "description": "", "item": [ { "id": "9bff6bb9-24c4-4437-8ee1-077f080005dc", "name": "List the session voter's vote packages on this ballot", "request": { "name": "List the session voter's vote packages on this ballot", "description": { "content": "By default returns only **active** packages — those in `draft`,\n`awaiting-signatures`, or `awaiting-submission`. Use\n`?includeTerminal=true` to broaden to terminal states\n(`hydra-confirmed`, `failed`, `cancelled`, `abandoned`), or\n`?status=` for an exact-match filter.\n\nEach package is enriched with the same derived fields the single-\npackage endpoint returns (`merkleRoot`, `signingPayloadHex`,\n`signedPayloadJson`, `multisig`).\n", "type": "text/plain" }, "url": { "path": [ "votes", ":ballotId", "packages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Exact-match status filter; takes precedence over `includeTerminal`. (This can only be one of draft,awaiting-signatures,awaiting-submission,broker-submitted,hydra-confirmed,failed,cancelled,abandoned)", "type": "text/plain" }, "key": "status", "value": "cancelled" }, { "disabled": false, "description": { "content": "When `true`, include terminal-state packages in the default filter. (This can only be one of true,false)", "type": "text/plain" }, "key": "includeTerminal", "value": "false" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "10" } ], "variable": [ { "type": "any", "value": "", "key": "ballotId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "token" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "a1f897c1-456a-49ef-a7ae-fba4efde7281", "name": "Newest-first list of packages", "originalRequest": { "url": { "path": [ "votes", ":ballotId", "packages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Exact-match status filter; takes precedence over `includeTerminal`. (This can only be one of draft,awaiting-signatures,awaiting-submission,broker-submitted,hydra-confirmed,failed,cancelled,abandoned)", "type": "text/plain" }, "key": "status", "value": "cancelled" }, { "disabled": false, "description": { "content": "When `true`, include terminal-state packages in the default filter. (This can only be one of true,false)", "type": "text/plain" }, "key": "includeTerminal", "value": "false" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "token", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"data\": [\n {\n \"_id\": \"\",\n \"status\": \"hydra-confirmed\",\n \"nonce\": \"\",\n \"voteHash\": \"\",\n \"hydraTxId\": \"\",\n \"ipfsCid\": \"\",\n \"confirmedAt\": \"\",\n \"signatures\": [\n {\n \"key\": \"\",\n \"coseSign1Hex\": \"\",\n \"coseKeyHex\": \"\",\n \"signature\": \"\"\n },\n {\n \"key\": \"\",\n \"coseSign1Hex\": \"\",\n \"coseKeyHex\": \"\",\n \"signature\": \"\"\n }\n ],\n \"merkleRoot\": \"\",\n \"signingPayloadHex\": \"\",\n \"signedPayloadJson\": \"\",\n \"multisig\": {\n \"required\": \"\",\n \"eligibleKeys\": [\n \"\",\n \"\"\n ],\n \"outstandingKeys\": [\n \"\",\n \"\"\n ],\n \"satisfied\": \"\"\n }\n },\n {\n \"_id\": \"\",\n \"status\": \"draft\",\n \"nonce\": \"\",\n \"voteHash\": \"\",\n \"hydraTxId\": \"\",\n \"ipfsCid\": \"\",\n \"confirmedAt\": \"\",\n \"signatures\": [\n {\n \"key\": \"\",\n \"coseSign1Hex\": \"\",\n \"coseKeyHex\": \"\",\n \"signature\": \"\"\n },\n {\n \"key\": \"\",\n \"coseSign1Hex\": \"\",\n \"coseKeyHex\": \"\",\n \"signature\": \"\"\n }\n ],\n \"merkleRoot\": \"\",\n \"signingPayloadHex\": \"\",\n \"signedPayloadJson\": \"\",\n \"multisig\": {\n \"required\": \"\",\n \"eligibleKeys\": [\n \"\",\n \"\"\n ],\n \"outstandingKeys\": [\n \"\",\n \"\"\n ],\n \"satisfied\": \"\"\n }\n }\n ],\n \"pagination\": {\n \"limit\": \"\",\n \"returned\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "485fbdc0-798a-4cfa-a348-dd55f106843d", "name": "Auth required", "originalRequest": { "url": { "path": [ "votes", ":ballotId", "packages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Exact-match status filter; takes precedence over `includeTerminal`. (This can only be one of draft,awaiting-signatures,awaiting-submission,broker-submitted,hydra-confirmed,failed,cancelled,abandoned)", "type": "text/plain" }, "key": "status", "value": "cancelled" }, { "disabled": false, "description": { "content": "When `true`, include terminal-state packages in the default filter. (This can only be one of true,false)", "type": "text/plain" }, "key": "includeTerminal", "value": "false" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "token", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "31693f7e-54eb-4a3c-8aa6-f4e9e94e4d22", "name": "Ballot not found or not Hydra-backed", "originalRequest": { "url": { "path": [ "votes", ":ballotId", "packages" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Exact-match status filter; takes precedence over `includeTerminal`. (This can only be one of draft,awaiting-signatures,awaiting-submission,broker-submitted,hydra-confirmed,failed,cancelled,abandoned)", "type": "text/plain" }, "key": "status", "value": "cancelled" }, { "disabled": false, "description": { "content": "When `true`, include terminal-state packages in the default filter. (This can only be one of true,false)", "type": "text/plain" }, "key": "includeTerminal", "value": "false" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "10" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "token", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "package", "description": "", "item": [ { "name": "{packageId}", "description": "", "item": [ { "id": "1fb996c1-8852-4529-aede-2330bd96c177", "name": "Current VotePackage state for the session voter", "request": { "name": "Current VotePackage state for the session voter", "description": {}, "url": { "path": [ "votes", ":ballotId", "package", ":packageId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "ballotId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } }, { "type": "any", "value": "", "key": "packageId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "token" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "e0df753f-be38-436b-b31a-9a3491c71ce0", "name": "Package", "originalRequest": { "url": { "path": [ "votes", ":ballotId", "package", ":packageId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" }, { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "packageId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "token", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"package\": {\n \"_id\": \"\",\n \"status\": \"broker-submitted\",\n \"nonce\": \"\",\n \"voteHash\": \"\",\n \"hydraTxId\": \"\",\n \"ipfsCid\": \"\",\n \"confirmedAt\": \"\",\n \"signatures\": [\n {\n \"key\": \"\",\n \"coseSign1Hex\": \"\",\n \"coseKeyHex\": \"\",\n \"signature\": \"\"\n },\n {\n \"key\": \"\",\n \"coseSign1Hex\": \"\",\n \"coseKeyHex\": \"\",\n \"signature\": \"\"\n }\n ],\n \"merkleRoot\": \"\",\n \"signingPayloadHex\": \"\",\n \"signedPayloadJson\": \"\",\n \"multisig\": {\n \"required\": \"\",\n \"eligibleKeys\": [\n \"\",\n \"\"\n ],\n \"outstandingKeys\": [\n \"\",\n \"\"\n ],\n \"satisfied\": \"\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "76c56c30-cc3c-4b03-80b3-2993063a043b", "name": "Voter-initiated abandonment of an in-flight package", "request": { "name": "Voter-initiated abandonment of an in-flight package", "description": { "content": "Marks a non-terminal package as `abandoned` and releases its\nreserved nonce back to the voter's nonce pool. Load-bearing\nrelease: Hydra enforces `signedPayload.nonce === currentVersion + 1`\nstrictly, so abandoning without release would break the voter's\nnext submission.\n\n- 403 `FORBIDDEN` if the authenticated voter doesn't own the\n package.\n- 404 `PACKAGE_NOT_FOUND` if no package with that id exists on\n this ballot.\n- 409 `PACKAGE_TERMINAL` if the package is already in a\n terminal state (hydra-confirmed, failed, cancelled,\n abandoned).\n\nFor multisig: only the original drafter (the session voter\nwhose userId matches the package's userId) can delete. The\nTTL sweep also uses this semantic on long-idle packages.\n", "type": "text/plain" }, "url": { "path": [ "votes", ":ballotId", "package", ":packageId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "ballotId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } }, { "type": "any", "value": "", "key": "packageId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "token" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "71a5365a-6be2-4306-babd-e76bd1430cbf", "name": "Package abandoned; nonce released.", "originalRequest": { "url": { "path": [ "votes", ":ballotId", "package", ":packageId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" }, { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "packageId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "token", "value": "" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"success\",\n \"package\": {\n \"id\": \"\",\n \"status\": \"abandoned\",\n \"nonce\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0ecea0f6-ada0-46e1-b4ee-5f3dd9d46374", "name": "Not the package owner", "originalRequest": { "url": { "path": [ "votes", ":ballotId", "package", ":packageId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" }, { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "packageId" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "token", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "3b423cc6-33f5-41ef-9194-43013ee86f09", "name": "Package not found", "originalRequest": { "url": { "path": [ "votes", ":ballotId", "package", ":packageId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" }, { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "packageId" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "token", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "9b6af40e-b0ff-4c5a-8b28-3e76b8621c53", "name": "Package already in a terminal state", "originalRequest": { "url": { "path": [ "votes", ":ballotId", "package", ":packageId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" }, { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "packageId" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "token", "value": "" } ], "method": "DELETE", "body": {} }, "status": "Conflict", "code": 409, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ] } ] }, { "name": "proposals", "description": "", "item": [ { "name": "{proposalId}", "description": "", "item": [ { "id": "8e567f69-bb79-40cf-9978-9469a1d6d5ec", "name": "Single proposal detail + parent ballot sidecar", "request": { "name": "Single proposal detail + parent ballot sidecar", "description": { "content": "Returns the full Proposal document plus a slim parent-ballot\nprojection (`_id`, `title`, `facets`, `status`, `source`,\n`voterType`, `voteWeighted`) so the detail page can render\nfacet labels without a second roundtrip.\n", "type": "text/plain" }, "url": { "path": [ "proposals", ":proposalId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "proposalId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "753255e0-4f93-403f-9434-24ac2123f9e2", "name": "Proposal + parent ballot sidecar", "originalRequest": { "url": { "path": [ "proposals", ":proposalId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "proposalId" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"data\": {},\n \"ballot\": {\n \"_id\": \"\",\n \"title\": \"\",\n \"facets\": [\n {\n \"key\": \"_5\",\n \"label\": \"\",\n \"type\": \"date\",\n \"multi\": false,\n \"options\": [\n \"\",\n \"\"\n ],\n \"unit\": \"\",\n \"sortable\": false,\n \"filterable\": true,\n \"defaultSort\": \"desc\"\n },\n {\n \"key\": \"V\",\n \"label\": \"\",\n \"type\": \"boolean\",\n \"multi\": false,\n \"options\": [\n \"\",\n \"\"\n ],\n \"unit\": \"\",\n \"sortable\": false,\n \"filterable\": true,\n \"defaultSort\": \"desc\"\n }\n ],\n \"status\": \"live\",\n \"source\": \"hydra\",\n \"voterType\": \"\",\n \"voteWeighted\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "86f7a9f3-0682-4552-8008-6c154e780e70", "name": "Proposal not found", "originalRequest": { "url": { "path": [ "proposals", ":proposalId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "proposalId" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"error\",\n \"code\": \"PROPOSAL_NOT_FOUND\",\n \"message\": \"\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] }, { "name": "ballot", "description": "", "item": [ { "name": "{ballotId}", "description": "", "item": [ { "id": "690a88c1-9c4c-4e3f-92b5-74ab477dcfdf", "name": "List proposals for a ballot, with facet-driven sort + filter", "request": { "name": "List proposals for a ballot, with facet-driven sort + filter", "description": { "content": "Sort and filter keys must be declared on `Ballot.facets[]`.\nMulti-value enum filters take CSV (e.g. `?filter[category]=a,b`);\nOR semantics. Unknown keys and attempts to sort on a\nnon-sortable facet return 400. Facets are frozen once the\nballot goes live, so the filter UI can safely cache the\nfacet list for the ballot's lifetime.\n", "type": "text/plain" }, "url": { "path": [ "proposals", "ballot", ":ballotId" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Facet key to sort by. Must have `sortable: true`.", "type": "text/plain" }, "key": "sort", "value": "" }, { "disabled": false, "description": { "content": " (This can only be one of asc,desc)", "type": "text/plain" }, "key": "dir", "value": "asc" }, { "disabled": false, "description": { "content": "Object of `filter[]=` filters. CSV split on\n`,`; OR within a single facet; AND across facets.\n", "type": "text/plain" }, "key": "filter[key_0]", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [ { "type": "any", "value": "", "key": "ballotId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": null }, "response": [ { "id": "0d82ad2f-0d46-4b8e-86ae-7cebbbbfe139", "name": "Paginated proposals", "originalRequest": { "url": { "path": [ "proposals", "ballot", ":ballotId" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Facet key to sort by. Must have `sortable: true`.", "type": "text/plain" }, "key": "sort", "value": "" }, { "disabled": false, "description": { "content": " (This can only be one of asc,desc)", "type": "text/plain" }, "key": "dir", "value": "asc" }, { "disabled": false, "description": { "content": "Object of `filter[]=` filters. CSV split on\n`,`; OR within a single facet; AND across facets.\n", "type": "text/plain" }, "key": "filter[key_0]", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": \"\",\n \"pagination\": {\n \"total\": \"\",\n \"page\": \"\",\n \"limit\": \"\"\n },\n \"applied\": {\n \"filters\": {\n \"key_0\": [\n \"\",\n \"\"\n ],\n \"key_1\": [\n \"\",\n \"\"\n ]\n },\n \"sort\": {\n \"key\": \"\",\n \"direction\": \"desc\",\n \"source\": \"fallback\"\n }\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f3b4616f-bf0f-4241-bdc9-7e1d36dc0a33", "name": "Unknown facet key, unsortable sort target, or bad filter value", "originalRequest": { "url": { "path": [ "proposals", "ballot", ":ballotId" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Facet key to sort by. Must have `sortable: true`.", "type": "text/plain" }, "key": "sort", "value": "" }, { "disabled": false, "description": { "content": " (This can only be one of asc,desc)", "type": "text/plain" }, "key": "dir", "value": "asc" }, { "disabled": false, "description": { "content": "Object of `filter[]=` filters. CSV split on\n`,`; OR within a single facet; AND across facets.\n", "type": "text/plain" }, "key": "filter[key_0]", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" } ] }, "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "42c001c4-3eba-40dc-b9cb-2faaa5cdb698", "name": "Ballot not found", "originalRequest": { "url": { "path": [ "proposals", "ballot", ":ballotId" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": "Facet key to sort by. Must have `sortable: true`.", "type": "text/plain" }, "key": "sort", "value": "" }, { "disabled": false, "description": { "content": " (This can only be one of asc,desc)", "type": "text/plain" }, "key": "dir", "value": "asc" }, { "disabled": false, "description": { "content": "Object of `filter[]=` filters. CSV split on\n`,`; OR within a single facet; AND across facets.\n", "type": "text/plain" }, "key": "filter[key_0]", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "1" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "25" } ], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" } ] }, "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ] }, { "name": "public", "description": "", "item": [ { "name": "ballots", "description": "", "item": [ { "id": "8eb74b76-c59a-4aea-84e2-ec6c9ef9af35", "name": "Public unified ballot listing (API-key gated, rate-limited)", "request": { "name": "Public unified ballot listing (API-key gated, rate-limited)", "description": {}, "url": { "path": [ "public", "ballots" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of legacy,hydra)", "type": "text/plain" }, "key": "source", "value": "hydra" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "x-api-key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "7c83b262-19da-4a31-bcf0-ceb7d86e0ec4", "name": "Paginated list", "originalRequest": { "url": { "path": [ "public", "ballots" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of legacy,hydra)", "type": "text/plain" }, "key": "source", "value": "hydra" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"\",\n \"source\": \"hydra\",\n \"title\": \"\",\n \"description\": \"\",\n \"status\": \"upcoming\",\n \"voterType\": \"\",\n \"voterGroups\": [\n {\n \"group\": \"stake\",\n \"powerSource\": \"StakeBased\"\n },\n {\n \"group\": \"drep\",\n \"powerSource\": \"CredentialBased\"\n }\n ],\n \"voterDescription\": \"\",\n \"voteWeighted\": \"\",\n \"votePeriodStart\": \"\",\n \"votePeriodEnd\": \"\",\n \"voteFilters\": \"\",\n \"ipfsHash\": \"\",\n \"proposalCount\": \"\",\n \"singleProposal\": \"\",\n \"hydra\": {\n \"endpoint\": \"\",\n \"headId\": \"\",\n \"ballotCid\": \"\",\n \"instancePolicyId\": \"\",\n \"headInfo\": {},\n \"ballot\": {}\n },\n \"provisionalResultsEnabled\": \"\",\n \"proposalSource\": {\n \"moduleId\": \"\",\n \"moduleUrl\": \"\",\n \"externalBallotId\": \"\",\n \"version\": \"\",\n \"importedAt\": \"\",\n \"importMethod\": \"upload\",\n \"importedBy\": \"\"\n },\n \"facets\": [\n {\n \"key\": \"AimZ8D_C2ij\",\n \"label\": \"\",\n \"type\": \"date\",\n \"multi\": false,\n \"options\": [\n \"\",\n \"\"\n ],\n \"unit\": \"\",\n \"sortable\": false,\n \"filterable\": true,\n \"defaultSort\": \"asc\"\n },\n {\n \"key\": \"EM\",\n \"label\": \"\",\n \"type\": \"date\",\n \"multi\": false,\n \"options\": [\n \"\",\n \"\"\n ],\n \"unit\": \"\",\n \"sortable\": false,\n \"filterable\": true,\n \"defaultSort\": \"desc\"\n }\n ],\n \"createdAt\": \"\",\n \"updatedAt\": \"\"\n },\n {\n \"id\": \"\",\n \"source\": \"hydra\",\n \"title\": \"\",\n \"description\": \"\",\n \"status\": \"upcoming\",\n \"voterType\": \"\",\n \"voterGroups\": [\n {\n \"group\": \"stake\",\n \"powerSource\": \"StakeBased\"\n },\n {\n \"group\": \"pool\",\n \"powerSource\": \"StakeBased\"\n }\n ],\n \"voterDescription\": \"\",\n \"voteWeighted\": \"\",\n \"votePeriodStart\": \"\",\n \"votePeriodEnd\": \"\",\n \"voteFilters\": \"\",\n \"ipfsHash\": \"\",\n \"proposalCount\": \"\",\n \"singleProposal\": \"\",\n \"hydra\": {\n \"endpoint\": \"\",\n \"headId\": \"\",\n \"ballotCid\": \"\",\n \"instancePolicyId\": \"\",\n \"headInfo\": {},\n \"ballot\": {}\n },\n \"provisionalResultsEnabled\": \"\",\n \"proposalSource\": {\n \"moduleId\": \"\",\n \"moduleUrl\": \"\",\n \"externalBallotId\": \"\",\n \"version\": \"\",\n \"importedAt\": \"\",\n \"importMethod\": \"upload\",\n \"importedBy\": \"\"\n },\n \"facets\": [\n {\n \"key\": \"0R\",\n \"label\": \"\",\n \"type\": \"enum\",\n \"multi\": false,\n \"options\": [\n \"\",\n \"\"\n ],\n \"unit\": \"\",\n \"sortable\": false,\n \"filterable\": true,\n \"defaultSort\": \"desc\"\n },\n {\n \"key\": \"-fy6iZ\",\n \"label\": \"\",\n \"type\": \"boolean\",\n \"multi\": false,\n \"options\": [\n \"\",\n \"\"\n ],\n \"unit\": \"\",\n \"sortable\": false,\n \"filterable\": true,\n \"defaultSort\": \"asc\"\n }\n ],\n \"createdAt\": \"\",\n \"updatedAt\": \"\"\n }\n ],\n \"pagination\": {\n \"total\": \"\",\n \"page\": \"\",\n \"limit\": \"\",\n \"totalPages\": \"\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "df463d94-e17a-48ee-8c14-ee9cb249dda3", "name": "Missing or invalid API key", "originalRequest": { "url": { "path": [ "public", "ballots" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of legacy,hydra)", "type": "text/plain" }, "key": "source", "value": "hydra" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "0fa21dda-f2eb-45a9-bac6-20206c3a3649", "name": "Scope mismatch", "originalRequest": { "url": { "path": [ "public", "ballots" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of legacy,hydra)", "type": "text/plain" }, "key": "source", "value": "hydra" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "21c1ad45-ac06-47c9-9a36-8491d364c4bd", "name": "Rate limit exceeded", "originalRequest": { "url": { "path": [ "public", "ballots" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "description": { "content": " (This can only be one of legacy,hydra)", "type": "text/plain" }, "key": "source", "value": "hydra" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "page", "value": "" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "limit", "value": "" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "name": "{id}", "description": "", "item": [ { "id": "534a1581-dc95-4d28-af1f-63549012e481", "name": "Public ballot detail", "request": { "name": "Public ballot detail", "description": {}, "url": { "path": [ "public", "ballots", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "id", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "x-api-key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "df69220a-569c-4e1d-82df-5081b273ae22", "name": "OK", "originalRequest": { "url": { "path": [ "public", "ballots", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ba01b4c4-58c5-4880-b75d-dc7a387bd036", "name": "Not found", "originalRequest": { "url": { "path": [ "public", "ballots", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "id" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "results", "description": "", "item": [ { "name": "ballot", "description": "", "item": [ { "name": "{ballotId}", "description": "", "item": [ { "id": "331e0ca1-0607-4c4d-88d8-503664bc5231", "name": "All Result rows for a ballot (provisional + final)", "request": { "name": "All Result rows for a ballot (provisional + final)", "description": {}, "url": { "path": [ "public", "results", "ballot", ":ballotId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "ballotId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "x-api-key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "f697b132-5c85-4f1f-bc24-4ae14c2ee786", "name": "Array of results", "originalRequest": { "url": { "path": [ "public", "results", "ballot", ":ballotId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "ballotId" } ] }, "header": [ { "key": "Accept", "value": "application/json" }, { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"proposalId\": \"\",\n \"ballotId\": \"\",\n \"source\": \"final\",\n \"ballotSource\": \"legacy\",\n \"finalizedAt\": \"\",\n \"hydraEvidenceCid\": \"\",\n \"hydraResultsCid\": \"\",\n \"hydraFinalizeTxHash\": \"\",\n \"hydraResultsHash\": \"\",\n \"hydraEvidenceMerkleRoot\": \"\",\n \"hydraTotalVoters\": \"\",\n \"hydraExcludedVoters\": [\n {\n \"tokenName\": \"\",\n \"reason\": \"\"\n },\n {\n \"tokenName\": \"\",\n \"reason\": \"\"\n }\n ],\n \"results\": [\n {\n \"id\": \"\",\n \"label\": \"\",\n \"count\": \"\",\n \"votingPower\": \"\"\n },\n {\n \"id\": \"\",\n \"label\": \"\",\n \"count\": \"\",\n \"votingPower\": \"\"\n }\n ],\n \"resultsByGroup\": {}\n },\n {\n \"proposalId\": \"\",\n \"ballotId\": \"\",\n \"source\": \"provisional\",\n \"ballotSource\": \"hydra\",\n \"finalizedAt\": \"\",\n \"hydraEvidenceCid\": \"\",\n \"hydraResultsCid\": \"\",\n \"hydraFinalizeTxHash\": \"\",\n \"hydraResultsHash\": \"\",\n \"hydraEvidenceMerkleRoot\": \"\",\n \"hydraTotalVoters\": \"\",\n \"hydraExcludedVoters\": [\n {\n \"tokenName\": \"\",\n \"reason\": \"\"\n },\n {\n \"tokenName\": \"\",\n \"reason\": \"\"\n }\n ],\n \"results\": [\n {\n \"id\": \"\",\n \"label\": \"\",\n \"count\": \"\",\n \"votingPower\": \"\"\n },\n {\n \"id\": \"\",\n \"label\": \"\",\n \"count\": \"\",\n \"votingPower\": \"\"\n }\n ],\n \"resultsByGroup\": {}\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] }, { "name": "proposal", "description": "", "item": [ { "name": "{proposalId}", "description": "", "item": [ { "id": "cc0f207c-34d0-45f0-8a7c-1cec0572f148", "name": "Single proposal result", "request": { "name": "Single proposal result", "description": {}, "url": { "path": [ "public", "results", "proposal", ":proposalId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "type": "any", "value": "", "key": "proposalId", "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" } } ] }, "method": "GET", "body": {}, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "x-api-key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "abe95fa7-3f07-4e56-a750-778e8b5aaf37", "name": "OK", "originalRequest": { "url": { "path": [ "public", "results", "proposal", ":proposalId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "proposalId" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [], "cookie": [], "_postman_previewlanguage": "text" }, { "id": "ec06019c-007c-462d-99d3-5289bc12b698", "name": "No results yet", "originalRequest": { "url": { "path": [ "public", "results", "proposal", ":proposalId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "description": { "content": "(Required) ", "type": "text/plain" }, "type": "any", "value": "", "key": "proposalId" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [], "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ] } ] } ] } ] } ], "event": [], "variable": [ { "key": "baseUrl", "value": "https://app.ekklesia.vote" } ], "info": { "_postman_id": "966384ee-f509-4fe7-b38b-f3e7e4064e4b", "name": "Ekklesia Voting Backend API — v1", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "Hydra-backed live surface for the Ekklesia voting platform. v1 is paired with the v0 archival surface (openapi.v0.yaml) — the two coexist. Covers the unified ballot listing across legacy + Hydra sources, the vote broker pipeline (draft / signature / submit), public audit artifacts (per-proposal canonical content, downloadable archive bundle, authority certification state), and the API-key gated public integrator surface under /public/*. Operational lifecycle endpoints (Hydra head management, ballot ingestion, voting-power uploads, authority certification ingest) are administrator-only and not part of the published surface. See the Voting API overview page for cross-cutting behavior (dual-id resolution, server-derived responderRole, query hygiene, authentication).\n\n\nContact Support:\n Name: Adam Dean, Mad Orkestra", "type": "text/plain" } } }