API & Integration

The current public API — every endpoint listed here is live

Cast a cryptographic vote

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:

# Message to sign (exact text):

Solon vote

session:<sessionId>

choice:<yes|no|abstain>

voter:<your-bitcoin-address>

# Submit the signed vote

curl -X POST /api/sessions/<sessionId>/votes \

-H "Content-Type: application/json" \

-d '{"choice":"yes","address":"1...","signature":"<base64>"}'

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/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.