Skip to content

Cicero

Overview

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

Location Query

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 QueryParameters
Latitude & Longitudelat, lon
Address(search_loc) OR (search_address, search_neighborhood, search_city, search_state, search_postal, search_country)
Postal Codesearch_postal, search_country

Product Page

Support Center

Download OpenAPI description
Languages
Servers
https://app.cicerodata.com/v3.1/

Officials

Use these endpoints to find elected officials.

Operations

Districts

Use these endpoints to find districts.

Operations

Map

Use this endpoint to get a map of district boundaries.

Operations

Get map image

Request

Cicero makes simple maps of district boundaries available through the map resource.

Use the id property from a District object with this resource to request an image showing the shape of the district. The appearance of the map can be configured beyond the default style with graphical parameters.

JSON and XML responses will contain the image as a data URI. Requests with format=image will return only the image.

Cost: 1 credit

Path
district_idnumberrequired

The id property from a District object.

Query
formatstring

Specify the desired format of the response.

Enum"json""xml"
Example: format=json
customer_idstring(password)required

The License Key issued by Melissa.

Example: customer_id={REPLACE-WITH-YOUR-LICENSE-KEY}
widthnumber

The width in pixels of the returned map image.

heightnumber

The height in pixels of the returned map image.

fill_colorstring

The color of the district's shape.

fill_opacitystring

The opacity of the district's shape.

boundary_widthnumber

The width of the district's outline.

boundary_colornumber

The color of the district's outline.

boundary_line_joinstring

The type of line joins for the district's outline.

map_formatstring

The format of the map image.

Default "png"
Enum"png""png8""png32""png256""jpeg"
srsstring

The EPSG code spatial reference system code for the map.

keystring(password)Deprecated

The License Key issued by Melissa.

curl -i -X GET \
  'https://app.cicerodata.com/v3.1/map/{district_id}?customer_id={REPLACE-WITH-YOUR-LICENSE-KEY}'

Responses

Successful response

Body
responseobject(ResponseMap)
Response
{ "response": { "errors": [], "messages": [], "results": {} } }

Events

Use these endpoints to find events.

Operations

Coverage

Use this endpoint to get Cicero's data coverage.

Operations

Account Credits Remaining

Use this endpoint to check the remaining credits for an account.

Operations

District Type

Use this endpoint to get information on district categories.

Operations

Version

Use this endpoint to check the current version of Cicero.

Operations