Repped API
Programmatic access to verified, sourced elected official data — federal, state, and local. One address → every representative, with districts, contact info, and data provenance.
Including hand-verified mayors across 5,500+ US municipalities — the local layer most alternatives skip.
Pricing Tiers
Subscribe to a paid tier
Paid tiers upgrade an existing API key — billing is tied to the email that key was registered with. Paste your key, pick a tier, and you'll be redirected to Stripe Checkout. No key yet? Get a free one first.
API Reference
GET /api/v1/representatives
Returns every elected official representing a location (federal → state legislators → mayors/local executives). Resolved via address geocode or direct lat/lng.
Authentication
Include your API key in the Authorization: Bearer YOUR_KEY header or x-api-key: YOUR_KEY header.
Parameters
| Param | Description |
|---|---|
| address | A US street address or place name (geocoded via Mapbox) |
| lat + lng | Direct coordinates (alternative to address) |
Example
curl -H "Authorization: Bearer YOUR_KEY" \ "https://repped-api.onrender.com/api/v1/representatives?address=1600+Pennsylvania+Ave+NW+Washington+DC"
Response
{
"coordinates": { "lat": 38.8977, "lng": -77.0365 },
"districts": { "state": "DC", "congressionalDistrict": "0" },
"officials": [
{
"id": "seed:potus",
"name": "President",
"office": "President",
"level": "federal",
"chamber": "executive",
"party": "...",
"phones": ["..."],
"urls": ["..."]
}
// ... more officials
],
"resolvedAddress": "1600 Pennsylvania Avenue NW, Washington, DC",
"_api": {
"tier": "free",
"usage_this_month": 42,
"monthly_cap": 1000
}
}GET /api/v1/usage
Returns the current key's usage stats for this calendar month.
curl -H "Authorization: Bearer YOUR_KEY" \ "https://repped-api.onrender.com/api/v1/usage"
Embeddable Widget
A drop-in “Find Your Rep” widget for any website is coming soon. For now, build directly against the API above. (The embed needs origin-scoped publishable keys before it ships — until then, keep your secret key server-side only.)
Get Your API Key
Sign up with your email to get a free API key (1,000 lookups/month). Upgrade anytime via Stripe.
No credit card required for the free tier. Keys are hashed at rest.