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}
Required. The official neighborhood of the location (in countries with postal designations e.g., Mexico).
The date the district is valid on or after. Date should be specified in a YYYY-MM-DD format.
The date the district is valid on or before. Date should be specified in a YYYY-MM-DD format.
The dates during which the district is valid. Dates should be specified in a YYYY-MM-DD format and separated by a comma. Use ALL to return every district in all valid date ranges.
The License Key issued by Melissa.
- https://app.cicerodata.com/v3.1/legislative_district
- 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/legislative_district?customer_id={REPLACE-WITH-YOUR-LICENSE-KEY}&lat=33.63756710910554&lon=-117.60695049134513'Response
{ "response": { "errors": [], "messages": [], "results": { … } } }
Request
Cicero tracks non-legislative district boundaries and makes information about the districts available through the nonlegislative_district resource. The types of non-legislative districts tracked by Cicero vary regionally. The default response ordering is by id.
Use location queries on this resource.
Cost: 1 credit
Query
The License Key issued by Melissa.
Example: customer_id={REPLACE-WITH-YOUR-LICENSE-KEY}
Required. The official neighborhood of the location (in countries with postal designations e.g., Mexico).
The date the district is valid on or after. Date should be specified in a YYYY-MM-DD format.
The date the district is valid on or before. Date should be specified in a YYYY-MM-DD format.
The dates during which the district is valid. Dates should be specified in a YYYY-MM-DD format and separated by a comma. Use ALL to return every district in all valid date ranges.
The License Key issued by Melissa.
- https://app.cicerodata.com/v3.1/nonlegislative_district
- 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/nonlegislative_district?customer_id={REPLACE-WITH-YOUR-LICENSE-KEY}&district_type=SCHOOL&lat=33.637562&lon=-117.606887'Response
{ "response": { "errors": [], "messages": [], "results": { … } } }