API & Integration

Cast a cryptographic vote

From outside a browser — an agent, a script — a vote is a Bitcoin signed message. Sign the canonical vote message with the wallet that holds your registered member address, then POST the signature:

The server recovers the public key from the signature and only stores the vote if it resolves to a registered member. Invalid signatures return 401; verified but ineligible votes return 422 — with the reason in both cases.

Live endpoints

Every read is public and auth-free. Open one.

• GET/api/orgs/[slug]organization and its public member rosterorganization and its public member roster
• GET/api/orgs/[slug]/proposalsevery proposal with its session stateevery proposal with its session state
• GET/api/orgs/[slug]/auditthe append-only audit streamthe append-only audit stream
• GET/api/orgs/[slug]/treasurylive on-chain treasury balanceslive on-chain treasury balances
• GET/api/orgs/[slug]/policies/[key]policy version historypolicy version history
• GET/api/sessions/[sessionId]session, its snapshotted rules, and the live tally
  session, its snapshotted rules, and the live tally
• GET/api/v1/decisions/[sessionId]self-verifying decision document — re-verify it, don't trust it
  self-verifying decision document — re-verify it, don't trust it
• GET/api/v1/places?q=places by postcode or name; a postcode spanning several places returns eachplaces by postcode or name; a postcode spanning several places returns each
• GET/api/v1/places/[...path]one official place: what it is part of, whether it levies tax, and its sourcesone official place: what it is part of, whether it levies tax, and its sources
• GET/api/v1/places/map?pack=every place a boundary file draws, with the tax figures along its chain, for maps that estimate in the browserevery place a boundary file draws, with the tax figures along its chain, for maps that estimate in the browser
• GET/api/v1/places/compare?p=what /compare shows, as data: each place's chain, the facts its tax model reads and the model — estimate wherever the income is; no income is sent herewhat /compare shows, as data: each place's chain, the facts its tax model reads and the model — estimate wherever the income is; no income is sent here
• GET/api/v1/places/geographyboundary files for maps, as a @bitbaum/geo-kit manifest with each file's sha256boundary files for maps, as a @bitbaum/geo-kit manifest with each file's sha256
• GET/api/v1/places/geography/[sha256].topojsonone boundary file, immutable: its name is its content
  one boundary file, immutable: its name is its content
• GET/api/healthservice healthservice health
• POST/api/members/registerclaim a member seat by signing with a Bitcoin key
  claim a member seat by signing with a Bitcoin key
• POST/api/proposalsfile a signed proposal
  file a signed proposal
• POST/api/proposals/[proposalId]/openopen the voting session and freeze the rules
  open the voting session and freeze the rules
• POST/api/sessions/[sessionId]/votescast a signed vote
  cast a signed vote
• POST/api/sessions/[sessionId]/closeclose after the window and decide the outcome
  close after the window and decide the outcome

All reads are public and auth-free — transparency is the product. On finalization Solon emits a decision.finalized webhook (HMAC-signed); consumers are expected to fetch the decision document and re-verify every signature locally rather than trust the notification.