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

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

Get district types

Request

Use the district_type resource to get information about the categories of both legislative and non-legislative districts in Cicero. The default response ordering is by name_short.

Cost: 0 credits

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}
keystring(password)Deprecated

The License Key issued by Melissa.

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

Responses

Successful response

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

Version

Use this endpoint to check the current version of Cicero.

Operations