Public docs

Politogy Statewide Voter Data API

Base URL

https://backend-api-production-c3d8.up.railway.app

All endpoints except /health require the x-api-key header. The API is designed for read-only access from agents, scripts, and secure dashboards.

Auth

Send x-api-key on every non-health request.

Primary data

Registered voters is the canonical query surface.

Agent prompt

A click-to-copy prompt is included for tool-using assistants.

GET

/health

Returns service health and current database time.

GET

/datasets

Returns imported dataset summaries and row counts.

GET

/registered-voters

Searches the main statewide registered voter dataset.

GET

/registered-voters/:voterId

Returns the full registered voter profile for a single voter ID.

GET

/voting-history

Returns voter history records and election participation arrays.

GET

/district-precincts

Returns district and precinct mapping details.

GET

/omv

Returns OMV attribution records by voter ID or county.

Agentic prompt

Copy this into your agent or workflow

Use the Politogy Statewide Voter Data API.
Base URL: https://backend-api-production-c3d8.up.railway.app
Authenticate every non-health request with the header x-api-key: YOUR_API_KEY.
Start with GET /datasets to inspect available record counts.
Use GET /registered-voters for primary voter lookup with search, county, partyCode, status, congressionalDistrict, page, and pageSize query params.
Use GET /registered-voters/:voterId when you already know the voter ID.
Use GET /voting-history to retrieve election participation arrays.
Use GET /district-precincts for district metadata and GET /omv for Motor Voter attribution.
Return concise summaries and preserve voter IDs exactly as provided by the API.