Skip to content
/Officials

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

https://www.melissa.com/cicero-api

Support Center

https://www.melissa.com/company/product-support

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

Officials

Use these endpoints to find elected officials.

Operations

Find elected officials

Request

Cicero tracks elected officials and makes their information available through the official resource. The default response ordering is by last_name, first_name.

Use location queries on this resource. You can also query for officials using the official's name.

Cost: 1 credit

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}
latstringrequired

Required. The latitude of the location.

Example: lat=33.63756710910554
lonstringrequired

Required. The longitude of the location.

Example: lon=-117.60695049134513
search_locstring

Required. One line address or a single search string.

search_addressstring

Required. The street address of the location.

search_neighborhoodstring

Required. The official neighborhood of the location (in countries with postal designations e.g., Mexico).

search_citystring

Required. The city of the location.

search_statestring

Required. The state of the location.

search_postalstring

Required. The postal code of the location.

search_countrystring

Required. The country of the location (Use ISO 3166-1 alpha-2 code).

last_namestring

Required. The official's last name.

first_namestring

The official's first name.

citystring

The city of the location used as a filter.

statestring

The state of the location used as a filter.

countrystring

The country of the location (Use ISO 3166-1 alpha-2 code) used as a filter.

orderstring

The name of the resource field by which to order the results.

sortstring

Whether to sort the results in ascending or descending order.

Default "asc"
Enum"asc""desc"
district_typestring

The type of district.

Example: district_type=NATIONAL_LOWER
district_idstring

The ID, number, or name of the official's district.

valid_onstring

The date the district is valid on. Date should be specified in a YYYY-MM-DD format.

valid_on_or_afterstring

The date the district is valid on or after. Date should be specified in a YYYY-MM-DD format.

valid_on_or_beforestring

The date the district is valid on or before. Date should be specified in a YYYY-MM-DD format.

valid_rangestring

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.

maxinteger<= 200

The maximum number of objects to return.

Default 40
offsetinteger

Number of items to skip in the response, starting from the beginning of the list.

keystring(password)Deprecated

The License Key issued by Melissa.

curl -i -X GET \
  'https://app.cicerodata.com/v3.1/official?customer_id={REPLACE-WITH-YOUR-LICENSE-KEY}&lat=33.63756710910554&lon=-117.60695049134513'

Responses

Successful response

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

Find elected officials by region

Request

This resource provides the ability to list elected officials by level and region rather than for a single geographic location. The endpoint is filtered by district type and region, and sorted by last_name, first_name.

Cost: 50 credits

Permission: Please contact the Cicero Team to request access to this resource.

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}
district_typestringrequired

The type of district.

Example: district_type=NATIONAL_LOWER
countrystringrequired

The country of the location (Use ISO 3166-1 alpha-2 code) used as a filter.

Example: country=US
citystring

The city of the location used as a filter.

statestring

The state of the location used as a filter.

Example: state=CA
district_idstring

The ID, number, or name of the official's district.

maxinteger

The maximum number of objects to return.

offsetinteger

Number of items to skip in the response, starting from the beginning of the list.

keystring(password)Deprecated

The License Key issued by Melissa.

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

Responses

Successful response

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

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

Version

Use this endpoint to check the current version of Cicero.

Operations