API Integration Overview
The VOTR APIs split into two services. This page is a map. Each surface below has its own page with an embedded playground — pick one and try it.
How a request flows
- Get a token with your client credentials → Authentication.
- Look up events for a record date → Events.
- Submit shareholders for relevant events → Shareholders.
- (Optional) Submit daily trades → Trades.
- Generate a voting URL when a shareholder clicks "Vote Now" → Voting.
- Pass the URL into the SDK → Installation covers the React Native side.
Hosts
| Concern | Host |
|---|---|
| Auth · Events · Voting | api-dev.govotr.com / api.govotr.com |
| Shareholders · Trades | shareholders-api-dev.govotr.com / shareholders-api.govotr.com |
Each operation in the embedded playgrounds pins its own server — pick Development or Production in the playground's server dropdown before firing a call.
Security model
The frontend should never hold your client_id / client_secret. Your backend exchanges them for an access token, then your backend (not the browser) calls VOTR. See Prerequisites → Security model for the full pattern.