Use these endpoints to find elected officials.
Cicero
Cicero is a powerful Cloud API designed to seamlessly match addresses or locations to legislative districts while providing comprehensive contact information for elected officials.
Things you might want to use Cicero for:
- Provide an elected official lookup tool on your website.
- Create constituent records in your database.
- Display district boundaries on a map.
- Show elected official profiles in your app.
Documentation
The primary way to get information from Cicero's database of officials and districts is through a location query.
When you include API call parameters that provide a location in the form of a latitude & longitude coordinate, street address, or postal code, Cicero will find that location on the Earth's surface and match it against a range of district boundaries. In this way, you can determine which elected official represents any home, business, or place in regions with Cicero coverage.
| Location Query | Parameters |
|---|---|
| Latitude & Longitude | lat, lon |
| Address | (search_loc) OR (search_address, search_neighborhood, search_city, search_state, search_postal, search_country) |
| Postal Code | search_postal, search_country |
Product Page
Support Center
Query
The License Key issued by Melissa.
Example: customer_id={REPLACE-WITH-YOUR-LICENSE-KEY}
The earliest date an election is completed. Use today for elections completing today or later. Date should be specified in a YYYY-MM-DD format.
Example: election_expire_date_on_or_after=today
The latest date an election is completed. Use tomorrow for elections completing before tomorrow. Date should be specified in a YYYY-MM-DD format.
The License Key issued by Melissa.
- https://app.cicerodata.com/v3.1/election_event
- curl
- C#
- Python
- Java
- JavaScript
- Node.js
- PHP
- Go
- Ruby
- R
- C#+Newtonsoft
- Java8+Apache
- Payload
curl -i -X GET \
'https://app.cicerodata.com/v3.1/election_event?customer_id={REPLACE-WITH-YOUR-LICENSE-KEY}'Response
{ "response": { "errors": [], "messages": [], "results": { … } } }
Query
The License Key issued by Melissa.
Example: customer_id={REPLACE-WITH-YOUR-LICENSE-KEY}
The date a redistricting event was begun. Use today for redistricting events that have already started. Date should be specified in a YYYY-MM-DD format.
Example: begin_date_before=today
The latest date a redistricting event is completed. Use tomorrow for redistricting events that are not yet completed. Date should be specified in a YYYY-MM-DD format.
Example: complete_date_after=tomorrow
The License Key issued by Melissa.
- https://app.cicerodata.com/v3.1/redistricting_event
- curl
- C#
- Python
- Java
- JavaScript
- Node.js
- PHP
- Go
- Ruby
- R
- C#+Newtonsoft
- Java8+Apache
- Payload
curl -i -X GET \
'https://app.cicerodata.com/v3.1/redistricting_event?customer_id={REPLACE-WITH-YOUR-LICENSE-KEY}'Response
{ "response": { "errors": [], "messages": [], "results": { … } } }