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
Request
The coverage resource provides a current list of national, region, and local governments for which Cicero maintains elected official data. It includes chamber names for all legislative chambers and a list of the non-legislative districts for which Cicero maintains geographic boundaries.
The response is organized by country, with states/provinces and non-legislative boundaries listed within each country and localities listed within each state/province. Each place contains a list of its legislative chambers, and each country also contains a list of its non-legislative district types.
Cost: 0 credits
Query
The License Key issued by Melissa.
Example: customer_id={REPLACE-WITH-YOUR-LICENSE-KEY}
The License Key issued by Melissa.
- https://app.cicerodata.com/v3.1/coverage
- 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/coverage?customer_id={REPLACE-WITH-YOUR-LICENSE-KEY}'Response
{ "response": { "errors": [], "messages": [], "results": { … } } }