Quickstart#
Introduction#
Welcome to the Cicero API, a powerful web service designed to seamlessly match addresses or locations to legislative districts while providing comprehensive contact information for elected officials. Whether you’re aiming to integrate an elected official lookup tool on your website, streamline constituent record creation in your database, visualize district boundaries on a map, or enrich your app with detailed elected official profiles, Cicero API has got you covered.
To explore the extensive capabilities of the Cicero API, you can sign up for a free trial. For current national, regional, and local coverage, refer to the Cicero Database Availability document or consult our Data Coverage resource
Credit#
Using the Cicero API costs one credit per call to each of these resources:
The Cicero Dashboard is where you’ll monitor your Cicero account. Use calls to the free usage and credits_remaining resources to programmatically access this information.
You can add more credits on the Purchase Credits page.
Getting Started#
What can I do?#
Officials resources#
Cicero diligently monitors elected officials and offers accessible access to their information through our official resource tool.
Endpoints#
/official#
Cicero monitors elected officials and offers their information through our official resource. By default, responses are ordered by
last_name, first_namefor optimal accessibility and organization, returning every elected official Cicero maintains for a single location.
Click here to go to the full endpoint documentation.
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=xml\
&key={{customerId}}"
/officials_by_region#
The “Officials by Region” resource enables users to list elected officials based on their level and region, rather than focusing solely on a single geographic location.
Click here to go to the full endpoint documentation.
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=xml\
&key={{customerId}}"
/legislative_district#
Cicero monitors legislative district boundaries and offers information about these districts through the legislative_district resource. By default, responses are ordered by id for streamlined access and organization.
Click here to go to the full endpoint documentation.
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=xml\
&key={{customerId}}"
/nonlegislative_district#
Cicero diligently monitors non-legislative district boundaries and provides information about these districts through the nonlegislative_district resource. The types of non-legislative districts tracked by Cicero may vary regionally. By default, responses are ordered by id for efficient retrieval and organization.
Click here to go to the full endpoint documentation.
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=xml\
&key={{customerId}}"
/map#
Cicero provides access to straightforward maps displaying district boundaries via the map resource.
Click here to go to the full endpoint documentation.
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=xml\
&key={{customerId}}"
/election_event#
Cicero monitors elections taking place in every country worldwide and offers information about these elections through the election_event resource. By default, responses are ordered based on election_expire_date for enhanced accessibility.
Click here to go to the full endpoint documentation.
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=xml\
&key={{customerId}}"
/redistricting_event#
Cicero keeps tabs on redistricting events and provides accessible information about them through the redistricting_event resource. By default, responses are sorted based on the begin_date for ease of reference.
Click here to go to the full endpoint documentation.
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=xml\
&key={{customerId}}"
/coverage#
The coverage resource offers an up-to-date inventory of national, region, and local governments for which Cicero curates data on elected officials. It encompasses chamber names for all legislative bodies, along with a comprehensive list of non-legislative districts for which Cicero maintains geographic boundaries.
Click here to go to the full endpoint documentation.
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=xml\
&key={{customerId}}"
account/credits_remaining#
Utilize the account/credits_remaining resource to monitor the remaining credits in your account.
Click here to go to the full endpoint documentation.
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=xml\
&key={{customerId}}"
/district_type#
Employ the district_type resource to access vital information regarding the classifications of both legislative and non-legislative districts within Cicero’s database. By default, responses are organized based on name_short, facilitating ease of reference and navigation.
Click here to go to the full endpoint documentation.
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=xml\
&key={{customerId}}"
/version#
Utilize the version resource to retrieve the latest version of the API.
Click here to go to the full endpoint documentation.
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/official/?\
&lat=33.63756710910554\
&lon=-117.60695049134513\
&district_type=NATIONAL_LOWER\
&format=xml\
&key={{customerId}}"
Sample Code#
Language |
Repository |
|---|---|
C# .NET |
|
Python3 |
