# 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** - [Cicero Documentation](https://docs.melissa.com/cloud-api/cicero/cicero-index.html) ### 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 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** [https://www.melissa.com/cicero-api](https://www.melissa.com/cicero-api) **Support Center** [https://www.melissa.com/company/product-support](https://www.melissa.com/company/product-support) ## Servers ``` https://app.cicerodata.com/v3.1 ``` ## Download OpenAPI description [Cicero](https://md-developer-portal-staging.redocly.app/_bundle/apis/cicero.yaml) ## Officials Use these endpoints to find elected officials. ### Find elected officials - [GET /official](https://md-developer-portal-staging.redocly.app/apis/cicero/officials/official.md): 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 ### Find elected officials by region - [GET /officials_by_region](https://md-developer-portal-staging.redocly.app/apis/cicero/officials/officials_by_region.md): 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. ## Districts Use these endpoints to find districts. ### Find legislative districts - [GET /legislative_district](https://md-developer-portal-staging.redocly.app/apis/cicero/districts/legislative_district.md): Cicero tracks legislative district boundaries and makes information about the districts available through the legislative_district resource. The default response ordering is by id. Use location queries on this resource. Cost: 1 credit ### Find non-legislative districts - [GET /nonlegislative_district](https://md-developer-portal-staging.redocly.app/apis/cicero/districts/nonlegislative_district.md): 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 ## Map Use this endpoint to get a map of district boundaries. ### Get map image - [GET /map/{district_id}](https://md-developer-portal-staging.redocly.app/apis/cicero/map/map.md): 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 ## Events Use these endpoints to find events. ### Find election events - [GET /election_event](https://md-developer-portal-staging.redocly.app/apis/cicero/events/election_event.md): Cicero tracks elections occurring in every country around the world and makes information about the elections available through the election_event resource. The default response ordering is by election_expire_date. Cost: 0 credits ### Find redistricting events - [GET /redistricting_event](https://md-developer-portal-staging.redocly.app/apis/cicero/events/redistricting_event.md): Cicero tracks redistricting events and makes information about them available through the redistricting_event resource.. The default response ordering is by begin_date. Cost: 0 credits ## Coverage Use this endpoint to get Cicero's data coverage. ### Find coverage - [GET /coverage](https://md-developer-portal-staging.redocly.app/apis/cicero/coverage/coverage.md): 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 ## Account Credits Remaining Use this endpoint to check the remaining credits for an account. ### Track remaining credits - [GET /account/credits_remaining](https://md-developer-portal-staging.redocly.app/apis/cicero/account-credits-remaining/account_credits_remaining.md): You can programmatically check on your account with the credits_remaining and usage resources. Use the account/credits_remaining resource to track how many credits are left in your account. Cost: 0 credits ## District Type Use this endpoint to get information on district categories. ### Get district types - [GET /district_type](https://md-developer-portal-staging.redocly.app/apis/cicero/district-type/district_type.md): 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 ## Version Use this endpoint to check the current version of Cicero. ### Get version - [GET /version](https://md-developer-portal-staging.redocly.app/apis/cicero/version/version.md): Use the version resource to get the current version of the API. Cost: 0 credits