Reference Guide#
Introduction#
The Cicero API is a web service that matches addresses or locations to legislative districts and returns contact information for elected officials.
Things you might want to use the Cicero API 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.
Base URL#
https://app.cicerodata.com/v3.1
Licensing#
There are two possible ways you can authenticate with the Cicero API:
API Key authentication
User ID and temporary Token authentication
These credentials allow access to the Cicero API and calls made with these credentials will use your credits.
API Key#
The My Profile page is where you’ll update your account information and generate an API Key. The API key will give you access to Cicero’s API resources.
With an API Key, format your authenticated calls as:
/{resource}?key={api_key}
User ID and Token#
Call for a temporary token and user ID from the /token/new.json endpoint.
/{resource}?user={user_id}&token={token}
Tokens are valid until the end of the following day, Universal Coordinated Time (UTC). For example, if it is Tuesday at 7 p.m. EDT (23:00 UTC), the token will be valid through Wednesday at 8 p.m. EDT (Thursday 00:00 UTC).
Setup your application to handle expiring tokens by calling for a new token whenever Cicero returns a 403 Forbidden HTTP response code. Then, try the call again.
End Points#
Request Parameters#
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.
Responses for these location queries can also be filtered by the type of district.
Latitude & Longitude#
A location query with a latitude and longitude coordinate pair requires two parameters:
Code |
Description |
|---|---|
lat |
The latitude of the location. |
long |
The longitude of the location. |
The response will list objects with boundaries, or constituent boundaries, that contain the coordinate location.
Using an exact latitude and longitude coordinate is more accurate than geocoding with a street address or postal code.
Address#
A location query with a street address uses a geocoding service to translate that information to a latitude and longitude coordinate, then matches the location to Cicero’s district boundaries.
Use the search_loc parameter to search for an address as a single string or use a parameter for each of the address components.
Searching with a single address string:
Code |
Description |
|---|---|
search_loc |
One line address or a single search string. |
Searching with multiple address components:
Code |
Description |
|---|---|
search_address |
The street address of the location. |
search_neighborhood |
The official neighborhood of the location (in countries with postal designations e.g., Mexico). |
search_city |
The city of the location. |
search_state |
The state of the location. |
search_postal |
The postal code of the location. |
search_country |
The country of the location (Use ISO 3166-1 alpha-2 code). |
The response will include a list of candidate locations for the provided address. An address that is vague or an address that could refer to more than one place will have multiple candidate locations. The location that is most likely to be correct is listed first.
Each candidate location object includes metadata about the geocoding match and a list of objects with boundaries, or constituent boundaries, that contain the geocoded address location.
Using a street address is less accurate than using a latitude and longitude coordinate, but more accurate than using only a postal code.
If a location query does not return any candidate location objects, there will be an empty response.
Postal Code#
A location query with only a postal code uses a geocoding service to approximate a center point for the postal code, then matches the location to Cicero’s district boundaries.
In the United States, postal codes are known as ZIP Codes. In addition to standard five-digit ZIP Codes, Cicero will also match to ZIP+4 or nine digit ZIP Codes. Using a ZIP+4 will be more accurate than a five-digit ZIP Code. ZIP+4 Codes can be formatted with or without the hyphen.
Use the search_postal and search_country parameter to search for a postal code.
Searching with a single address string:
Code |
Description |
|---|---|
search_postal |
The postal code of the location. |
search_country |
The country of the location (Use ISO 3166-1 alpha-2 code). |
/official#
Introduction#
Cicero tracks elected officials and makes their information available through the official resource. The default response ordering is by last_name, first_name.
Cost: 1 credit
Use location queries on this resource. You can also query for officials using the official’s name.
Response results include a list of official objects. By default, up to 40 officials are returned, but you can increase that up to 200 with the max parameter.
Order by District Type#
Passing order=district_type as a query parameter will cause the returned officials to be sorted by the type of district with which each official is associated. This sorting applies to legislative (including executive) districts only.
The default sort order is:
Transnational
National
State
Local
Within each level, the ordering is:
Executive
Upper
Lower
After district ordering has been applied, officials are sorted by last_name, first_name.
The district-level ordering can be reversed by passing the sort=desc parameter.
Query by Name#
Use name parameters to query for information about a specific official. The response will include all officials currently in office who match that name.
Code |
Description |
|---|---|
last_name |
The official’s last name |
valid_range |
The dates during which district is valid between. 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. |
valid_on_or_after |
The date the district is valid on or after. Date should be specified in a YYYY-MM-DD format. |
valid_on_or_before |
The date the district is valid on or before. Date should be specified in a YYYY-MM-DD format. |
first_name (optional) |
The official’s first name |
Combine any of these parameters with a location query to filter responses.
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}}"
Response#
{
"response": {
"errors": [],
"messages": [],
"results": {
"officials": [
{
"id": 465917,
"sk": 343935,
"valid_from": "2021-01-22 00:00:00",
"valid_to": "2025-01-20 00:00:00",
"last_update_date": "2023-08-01 06:43:00.678324",
"salutation": "",
"first_name": "Lloyd",
"middle_initial": "J.",
"last_name": "Austin",
"nickname": "",
"preferred_name": "",
"name_suffix": "III",
"office": {
"id": 465917,
"sk": 343935,
"valid_from": "2021-01-22 00:00:00",
"valid_to": "2025-01-20 00:00:00",
"last_update_date": "2023-08-01 06:43:00.678324",
"district": {
"id": 19,
"sk": 19,
"valid_from": "0001-01-01 04:56:02",
"valid_to": null,
"last_update_date": "2012-03-18 07:46:32",
"district_type": "NATIONAL_EXEC",
"subtype": "NATION",
"country": "US",
"state": "",
"city": "",
"district_id": "UNITED STATES",
"label": "United States",
"num_officials": 26,
"ocd_id": "ocd-division/country:us",
"data": {}
},
"representing_city": "",
"representing_state": "",
"representing_country": {
"status": "UN Member State",
"name_short": "United States",
"gmi_3": "USA",
"valid_from": "0001-01-01 00:00:00",
"name_short_iso": "United States",
"name_short_local": "United States",
"valid_to": null,
"id": 270,
"sk": 247,
"name_short_un": "United States of America",
"version": 1,
"fips": "US",
"last_update_date": "2012-10-10 17:29:57.613222",
"iso_3": "USA",
"iso_2": "US",
"iso_3_numeric": 840,
"name_long_local": "United States of America",
"name_long": "United States of America"
},
"notes": "",
"title": "Secretary of Defense",
"chamber": {
"legislature_update_date": null,
"official_count": 1,
"id": 7703,
"term_length": "Serves at the pleasure of the President",
"term_limit": "No term limits.",
"inauguration_rules": "The Secretary takes office immediately upon confirmation by the Senate.",
"name_native_language": "",
"contact_phone": "",
"name_formal": "United States Secretary of Defense",
"election_frequency": "",
"government": {
"name": "United States of America",
"type": "NATIONAL",
"city": "",
"state": "",
"country": {
"status": "UN Member State",
"name_short": "United States",
"gmi_3": "USA",
"valid_from": "0001-01-01 00:00:00",
"name_short_iso": "United States",
"name_short_local": "United States",
"valid_to": null,
"id": 270,
"sk": 247,
"name_short_un": "United States of America",
"version": 1,
"fips": "US",
"last_update_date": "2012-10-10 17:29:57.613222",
"iso_3": "USA",
"iso_2": "US",
"iso_3_numeric": 840,
"name_long_local": "United States of America",
"name_long": "United States of America"
},
"notes": ""
},
"redistricting_rules": "",
"vacancy_rules": "Vacancies are filled via appointment by the President pending confirmation by the Senate.",
"is_chamber_complete": true,
"contact_email": "",
"last_update_date": "2021-07-20 15:43:37.994626",
"remarks": "The Secretary serves at the pleasure of the President and may be removed from office at any time without approval from the Senate.",
"name": "Secretary of Defense",
"url": "https://www.defense.gov/",
"type": "EXEC",
"notes": "",
"has_geographic_representation": false,
"is_appointed": true,
"election_rules": "Appointees are nominated by the President and confirmed by the Senate via simple majority at a confirmation hearing. If the Senate is not in session, the President may directly appoint an acting Secretary who serves pending confirmation by the Senate."
},
"election_rules": ""
},
"initial_term_start_date": null,
"current_term_start_date": "2021-01-22 00:00:00",
"term_end_date": "2025-01-20 00:00:00",
"addresses": [
{
"address_1": "1000 Defense Pentagon",
"address_2": "",
"address_3": "",
"city": "Washington",
"county": "",
"state": "DC",
"postal_code": "20301",
"phone_1": "(703) 571-8951",
"fax_1": "",
"phone_2": "",
"fax_2": ""
}
],
"email_addresses": [],
"web_form_url": "",
"urls": [
"https://www.defense.gov/our-story/meet-the-team/secretary-of-defense/"
],
"photo_origin_url": "https://media.defense.gov/2021/Jan/29/2002592436/825/780/0/210123-A-CN110-0001.JPG",
"photo_cropping": null,
"notes": [
"Lloyd James Austin III was sworn in as the 28th Secretary of Defense on January 22, 2021. Mr. Austin is the principal assistant to the President in all matters relating to the Department of Defense and serves on the National Security Council.\\n\\nMr. Austin was born in Mobile, Alabama, and raised in Thomasville, Georgia. He graduated from the United States Military Academy with a Bachelor of Science degree and a commission in the Infantry. He holds a Master of Arts degree in counselor education from Auburn University, and a Master of Business Management from Webster University. He is a graduate of the Infantry Officer Basic and Advanced courses, the Army Command and General Staff College, and the Army War College.\\n\\nHis 41-year career in the Army included command at the corps, division, battalion, and brigade levels. Mr. Austin was awarded the Silver Star for his leadership of the Army’s 3rd Infantry Division during the invasion of Iraq in 2003. Seven years later, he would assume the duties of Commanding General of United States Forces – Iraq, overseeing all combat operations in the country. \\n\\nAfter a tour as the Army’s Vice Chief of Staff, Mr. Austin concluded his uniformed service as the Commander of U.S. Central Command, responsible for all military operations in the Middle East and Afghanistan. In this assignment, he led U.S. and coalition efforts to battle ISIS in Iraq and Syria. He retired from the Army in April, 2016.\\n\\nSince his retirement from military service, Mr. Austin served on the Boards of Directors for Raytheon Technologies, Nucor, and Tenet Healthcare.",
"1953-08-08"
],
"committees": [],
"party": "",
"identifiers": [
{
"official": 465917,
"version": 1,
"identifier_type": "FLICKR",
"valid_to": "2025-01-20 00:00:00",
"sk": 995717,
"valid_from": "2021-01-22 00:00:00",
"last_update_date": "2023-08-01 06:43:00.678324",
"id": 995717,
"identifier_value": "secdef"
},
{
"official": 465917,
"version": 1,
"identifier_type": "TWITTER",
"valid_to": "2025-01-20 00:00:00",
"sk": 995716,
"valid_from": "2021-01-22 00:00:00",
"last_update_date": "2023-08-01 06:43:00.678324",
"id": 995716,
"identifier_value": "SecDef"
},
{
"official": 465917,
"version": 1,
"identifier_type": "VOTESMART",
"valid_to": "2025-01-20 00:00:00",
"sk": 995718,
"valid_from": "2021-01-22 00:00:00",
"last_update_date": "2023-08-01 06:43:00.678324",
"id": 995718,
"identifier_value": "195717"
}
],
"titles": []
}
],
"count": {
"from": 0,
"to": 0,
"total": 49
}
}
}
}
<response>
<errors />
<messages />
<results>
<officials>
<official>
<id>465917</id>
<sk>343935</sk>
<valid_from>2021-01-22 00:00:00</valid_from>
<valid_to>2025-01-20 00:00:00</valid_to>
<last_update_date>2023-08-01 06:43:00.678324</last_update_date>
<salutation />
<first_name>Lloyd</first_name>
<middle_initial>J.</middle_initial>
<last_name>Austin</last_name>
<nickname />
<preferred_name />
<name_suffix>III</name_suffix>
<office>
<id>465917</id>
<sk>343935</sk>
<valid_from>2021-01-22 00:00:00</valid_from>
<valid_to>2025-01-20 00:00:00</valid_to>
<last_update_date>2023-08-01 06:43:00.678324</last_update_date>
<district>
<id>19</id>
<sk>19</sk>
<valid_from>0001-01-01 04:56:02</valid_from>
<valid_to>None</valid_to>
<last_update_date>2012-03-18 07:46:32</last_update_date>
<district_type>NATIONAL_EXEC</district_type>
<subtype>NATION</subtype>
<country>US</country>
<state />
<city />
<district_id>UNITED STATES</district_id>
<label>United States</label>
<num_officials>26</num_officials>
<ocd_id>ocd-division/country:us</ocd_id>
<data />
</district>
<representing_city />
<representing_state />
<representing_country>
<status>UN Member State</status>
<name_short>United States</name_short>
<gmi_3>USA</gmi_3>
<valid_from>0001-01-01 00:00:00</valid_from>
<name_short_iso>United States</name_short_iso>
<name_short_local>United States</name_short_local>
<valid_to>None</valid_to>
<id>270</id>
<sk>247</sk>
<name_short_un>United States of America</name_short_un>
<version>1</version>
<fips>US</fips>
<last_update_date>2012-10-10 17:29:57.613222</last_update_date>
<iso_3>USA</iso_3>
<iso_2>US</iso_2>
<iso_3_numeric>840</iso_3_numeric>
<name_long_local>United States of America</name_long_local>
<name_long>United States of America</name_long>
</representing_country>
<notes />
<title>Secretary of Defense</title>
<chamber>
<legislature_update_date>None</legislature_update_date>
<official_count>1</official_count>
<id>7703</id>
<term_length>Serves at the pleasure of the President</term_length>
<term_limit>No term limits.</term_limit>
<inauguration_rules>The Secretary takes office immediately upon confirmation by the Senate.</inauguration_rules>
<name_native_language />
<contact_phone />
<name_formal>United States Secretary of Defense</name_formal>
<election_frequency />
<government>
<name>United States of America</name>
<type>NATIONAL</type>
<city />
<state />
<country>
<status>UN Member State</status>
<name_short>United States</name_short>
<gmi_3>USA</gmi_3>
<valid_from>0001-01-01 00:00:00</valid_from>
<name_short_iso>United States</name_short_iso>
<name_short_local>United States</name_short_local>
<valid_to>None</valid_to>
<id>270</id>
<sk>247</sk>
<name_short_un>United States of America</name_short_un>
<version>1</version>
<fips>US</fips>
<last_update_date>2012-10-10 17:29:57.613222</last_update_date>
<iso_3>USA</iso_3>
<iso_2>US</iso_2>
<iso_3_numeric>840</iso_3_numeric>
<name_long_local>United States of America</name_long_local>
<name_long>United States of America</name_long>
</country>
<notes />
</government>
<redistricting_rules />
<vacancy_rules>Vacancies are filled via appointment by the President pending confirmation by the Senate.</vacancy_rules>
<is_chamber_complete>True</is_chamber_complete>
<contact_email />
<last_update_date>2021-07-20 15:43:37.994626</last_update_date>
<remarks>The Secretary serves at the pleasure of the President and may be removed from office at any time without approval from the Senate.</remarks>
<name>Secretary of Defense</name>
<url>https://www.defense.gov/</url>
<type>EXEC</type>
<notes />
<has_geographic_representation>False</has_geographic_representation>
<is_appointed>True</is_appointed>
<election_rules>Appointees are nominated by the President and confirmed by the Senate via simple majority at a confirmation hearing. If the Senate is not in session, the President may directly appoint an acting Secretary who serves pending confirmation by the Senate.</election_rules>
</chamber>
<election_rules />
</office>
<initial_term_start_date>None</initial_term_start_date>
<current_term_start_date>2021-01-22 00:00:00</current_term_start_date>
<term_end_date>2025-01-20 00:00:00</term_end_date>
<addresses>
<address>
<address_1>1000 Defense Pentagon</address_1>
<address_2 />
<address_3 />
<city>Washington</city>
<county />
<state>DC</state>
<postal_code>20301</postal_code>
<phone_1>(703) 571-8951</phone_1>
<fax_1 />
<phone_2 />
<fax_2 />
</address>
</addresses>
<email_addresses />
<web_form_url />
<urls>
<url>https://www.defense.gov/our-story/meet-the-team/secretary-of-defense/</url>
</urls>
<photo_origin_url>https://media.defense.gov/2021/Jan/29/2002592436/825/780/0/210123-A-CN110-0001.JPG</photo_origin_url>
<photo_cropping>None</photo_cropping>
<notes>
<note>Lloyd James Austin III was sworn in as the 28th Secretary of Defense on January 22, 2021. Mr. Austin is the principal assistant to the President in all matters relating to the Department of Defense and serves on the National Security Council.\n\nMr. Austin was born in Mobile, Alabama, and raised in Thomasville, Georgia. He graduated from the United States Military Academy with a Bachelor of Science degree and a commission in the Infantry. He holds a Master of Arts degree in counselor education from Auburn University, and a Master of Business Management from Webster University. He is a graduate of the Infantry Officer Basic and Advanced courses, the Army Command and General Staff College, and the Army War College.\n\nHis 41-year career in the Army included command at the corps, division, battalion, and brigade levels. Mr. Austin was awarded the Silver Star for his leadership of the Army’s 3rd Infantry Division during the invasion of Iraq in 2003. Seven years later, he would assume the duties of Commanding General of United States Forces – Iraq, overseeing all combat operations in the country. \n\nAfter a tour as the Army’s Vice Chief of Staff, Mr. Austin concluded his uniformed service as the Commander of U.S. Central Command, responsible for all military operations in the Middle East and Afghanistan. In this assignment, he led U.S. and coalition efforts to battle ISIS in Iraq and Syria. He retired from the Army in April, 2016.\n\nSince his retirement from military service, Mr. Austin served on the Boards of Directors for Raytheon Technologies, Nucor, and Tenet Healthcare.</note>
<note>1953-08-08</note>
</notes>
<committees />
<party />
<identifiers>
<identifier>
<official>465917</official>
<version>1</version>
<identifier_type>FLICKR</identifier_type>
<valid_to>2025-01-20 00:00:00</valid_to>
<sk>995717</sk>
<valid_from>2021-01-22 00:00:00</valid_from>
<last_update_date>2023-08-01 06:43:00.678324</last_update_date>
<id>995717</id>
<identifier_value>secdef</identifier_value>
</identifier>
<identifier>
<official>465917</official>
<version>1</version>
<identifier_type>TWITTER</identifier_type>
<valid_to>2025-01-20 00:00:00</valid_to>
<sk>995716</sk>
<valid_from>2021-01-22 00:00:00</valid_from>
<last_update_date>2023-08-01 06:43:00.678324</last_update_date>
<id>995716</id>
<identifier_value>SecDef</identifier_value>
</identifier>
<identifier>
<official>465917</official>
<version>1</version>
<identifier_type>VOTESMART</identifier_type>
<valid_to>2025-01-20 00:00:00</valid_to>
<sk>995718</sk>
<valid_from>2021-01-22 00:00:00</valid_from>
<last_update_date>2023-08-01 06:43:00.678324</last_update_date>
<id>995718</id>
<identifier_value>195717</identifier_value>
</identifier>
</identifiers>
<titles />
</official>
</officials>
<count>
<from>0</from>
<to>0</to>
<total>49</total>
</count>
</results>
</response>
/officials_by_region#
Introduction#
The “Officials by Region” resource provides the ability to list elected officials by level and region rather than for a single geographic location.
Cost: 50 credits
Permission: Please contact the Cicero Team to request access to this resource.
Response results include a list of abbreviated official objects, which contain a limited subset of the information in the full Officials response. By default, the first 100 officials will be returned, but see the Pagination section for how to use the max and offset parameters to access the complete set of results.
The endpoint is filtered by district type and region, and sorted by last_name, first_name.
Code |
Description |
|---|---|
district_type |
The type of district. |
country |
The country of the official’s district. |
state |
The state of the official’s district. |
city |
The city of the official’s district. |
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/officials_by_region?\
&district_type=NATIONAL_LOWER\
&country=US\
&state=CA\
&format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/officials_by_region?\
&district_type=NATIONAL_LOWER\
&country=US\
&state=CA\
&format=xml\
&key={{customerId}}"
Response#
{
"response": {
"errors": [],
"messages": [],
"results": {
"officials": [
{
"first_name": "Peter",
"middle_initial": "",
"last_name": "Aguilar",
"preferred_name": "Pete",
"salutation": "Honorable",
"name_suffix": "",
"sk": 86313,
"party": "Democrat",
"district": {
"district_id": "33",
"district_type__name_short": "NATIONAL_LOWER",
"subtype": "LOWER",
"label": "California's 33rd Congressional District"
},
"state": "CA",
"chamber__name_formal": "United States House of Representatives",
"title": "Representative",
"addresses": [
{
"address_1": "108 Cannon House Office Building",
"address_2": "",
"address_3": "",
"city": "Washington",
"county": "",
"state": "DC",
"postal_code": "20515",
"phone_1": "(202) 225-3201",
"fax_1": "",
"phone_2": "",
"fax_2": ""
}
],
"email_addresses": [],
"phone_1": "(202) 225-3201",
"phone_2": "",
"photo_origin_url": "https://bioguide.congress.gov/bioguide/photo/A/A000371.jpg",
"web_form_url": "https://aguilar.house.gov/email-me/",
"valid_from": "2023-01-03 00:00:00",
"valid_to": "2025-01-03 00:00:00",
"identifiers": [
{
"identifier_type": "FACEBOOK-OFFICIAL",
"identifier_value": "https://www.facebook.com/reppeteaguilar/"
},
{
"identifier_type": "TWITTER",
"identifier_value": "reppeteaguilar"
}
]
}
],
"count": {
"from": 0,
"to": 51,
"total": 52
}
}
}
}
<response>
<errors />
<messages />
<results>
<officials>
<official>
<first_name>Peter</first_name>
<middle_initial />
<last_name>Aguilar</last_name>
<preferred_name>Pete</preferred_name>
<salutation>Honorable</salutation>
<name_suffix />
<sk>86313</sk>
<party>Democrat</party>
<district>
<district_id>33</district_id>
<district_type__name_short>NATIONAL_LOWER</district_type__name_short>
<subtype>LOWER</subtype>
<label>California's 33rd Congressional District</label>
</district>
<state>CA</state>
<chamber__name_formal>United States House of Representatives</chamber__name_formal>
<title>Representative</title>
<addresses>
<address>
<address_1>108 Cannon House Office Building</address_1>
<address_2 />
<address_3 />
<city>Washington</city>
<county />
<state>DC</state>
<postal_code>20515</postal_code>
<phone_1>(202) 225-3201</phone_1>
<fax_1 />
<phone_2 />
<fax_2 />
</address>
</addresses>
<email_addresses />
<phone_1>(202) 225-3201</phone_1>
<phone_2 />
<photo_origin_url>https://bioguide.congress.gov/bioguide/photo/A/A000371.jpg</photo_origin_url>
<web_form_url>https://aguilar.house.gov/email-me/</web_form_url>
<valid_from>2023-01-03 00:00:00</valid_from>
<valid_to>2025-01-03 00:00:00</valid_to>
<identifiers>
<identifier>
<identifier_type>FACEBOOK-OFFICIAL</identifier_type>
<identifier_value>https://www.facebook.com/reppeteaguilar/</identifier_value>
</identifier>
<identifier>
<identifier_type>TWITTER</identifier_type>
<identifier_value>reppeteaguilar</identifier_value>
</identifier>
</identifiers>
</official>
</officials>
<count>
<from>0</from>
<to>51</to>
<total>52</total>
</count>
</results>
</response>
All parameters can be provided more than once to include multiple values. Results will be filtered to districts matching any of the values for a given parameter.
Which parameters are required depends on what district types are selected:
Query param |
NATIONAL_* |
STATE_* |
LOCAL_* |
|---|---|---|---|
country |
X |
X |
X |
state |
X |
X |
|
city |
X |
Since the endpoint supports looking up officials from multiple levels in a single request, the region filters are applied differently depending on the district type. Query parameters will filter different district types as follows:
Query param |
NATIONAL_* |
STATE_* |
LOCAL_* |
|---|---|---|---|
country |
X |
X |
X |
state |
X |
X |
X |
city |
X |
In other words:
NATIONAL_* district types will filter Officials to all districts matching country and state, but will ignore city.
STATE_* district types will filter in the same way as NATIONAL. This means that retrieving a state-level chamber will return all officials in that chamber, even if the request includes a city filter.
LOCAL_* district types will be filtered by country, state, and city.
/legislative_district#
Introduction#
Cicero tracks legislative district boundaries and makes information about the districts available through the legislative_district resource. The default response ordering is by id.
Cost: 1 credit
Use location queries on this resource.
Response results include a list of district objects.
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/legislative_district?\
lat=33.63756710910554\
&lon=-117.60695049134513\
&format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/legislative_district?\
lat=33.63756710910554\
&lon=-117.60695049134513\
&format=xml\
&key={{customerId}}"
Response#
{
"response": {
"errors": [],
"messages": [],
"results": {
"districts": [
{
"id": 19,
"sk": 19,
"valid_from": "0001-01-01 04:56:02",
"valid_to": null,
"last_update_date": "2012-03-18 07:46:32",
"district_type": "NATIONAL_EXEC",
"subtype": "EXEC",
"country": "US",
"state": "",
"city": "",
"district_id": "UNITED STATES",
"label": "United States",
"num_officials": 26,
"ocd_id": "ocd-division/country:us",
"data": {}
},
{
"id": 875000,
"sk": 875000,
"valid_from": "0001-01-01 04:56:02",
"valid_to": null,
"last_update_date": "2019-10-22 00:00:00",
"district_type": "STATE_EXEC",
"subtype": "EXEC",
"country": "US",
"state": "CA",
"city": "",
"district_id": "CA",
"label": "California",
"num_officials": 17,
"ocd_id": "ocd-division/country:us/state:ca",
"data": {}
},
{
"id": 875101,
"sk": 875101,
"valid_from": "1977-05-18 00:00:00",
"valid_to": null,
"last_update_date": "2019-10-23 00:00:00",
"district_type": "NATIONAL_UPPER",
"subtype": "UPPER",
"country": "US",
"state": "CA",
"city": "",
"district_id": "CA",
"label": "California",
"num_officials": 2,
"ocd_id": "ocd-division/country:us/state:ca",
"data": {}
},
{
"id": 901844,
"sk": 757235,
"valid_from": "2023-01-03 00:00:00",
"valid_to": "2033-01-03 00:00:00",
"last_update_date": "2021-12-22 18:09:05.314860",
"district_type": "NATIONAL_LOWER",
"subtype": "LOWER",
"country": "US",
"state": "CA",
"city": "",
"district_id": "40",
"label": "California's 40th Congressional District",
"num_officials": 1,
"ocd_id": "ocd-division/country:us/state:ca/cd:40",
"data": {}
},
{
"id": 901897,
"sk": 752732,
"valid_from": "2022-12-05 00:00:00",
"valid_to": null,
"last_update_date": "2021-12-22 18:11:28.991809",
"district_type": "STATE_UPPER",
"subtype": "UPPER",
"country": "US",
"state": "CA",
"city": "",
"district_id": "38",
"label": "California State Senate district 38",
"num_officials": 1,
"ocd_id": "ocd-division/country:us/state:ca/sldu:38",
"data": {}
},
{
"id": 901972,
"sk": 752685,
"valid_from": "2022-12-05 00:00:00",
"valid_to": null,
"last_update_date": "2021-12-22 18:13:46.775290",
"district_type": "STATE_LOWER",
"subtype": "LOWER",
"country": "US",
"state": "CA",
"city": "",
"district_id": "71",
"label": "California Assembly district 71",
"num_officials": 1,
"ocd_id": "ocd-division/country:us/state:ca/sldl:71",
"data": {}
},
{
"id": 903439,
"sk": 895322,
"valid_from": "2023-01-03 00:00:00",
"valid_to": null,
"last_update_date": "2022-02-01 18:54:38.386223",
"district_type": "LOCAL",
"subtype": "COUNTY",
"country": "US",
"state": "CA",
"city": "Orange County",
"district_id": "3",
"label": "Orange County Board of Supervisors district 3",
"num_officials": 1,
"ocd_id": "ocd-division/country:us/state:ca/county:orange/council_district:3",
"data": {}
}
],
"count": {
"from": 0,
"to": 6,
"total": 7
}
}
}
}
<response>
<errors />
<messages />
<results>
<districts>
<district>
<id>19</id>
<sk>19</sk>
<valid_from>0001-01-01 04:56:02</valid_from>
<valid_to>None</valid_to>
<last_update_date>2012-03-18 07:46:32</last_update_date>
<district_type>NATIONAL_EXEC</district_type>
<subtype>EXEC</subtype>
<country>US</country>
<state />
<city />
<district_id>UNITED STATES</district_id>
<label>United States</label>
<num_officials>26</num_officials>
<ocd_id>ocd-division/country:us</ocd_id>
<data />
</district>
<district>
<id>875000</id>
<sk>875000</sk>
<valid_from>0001-01-01 04:56:02</valid_from>
<valid_to>None</valid_to>
<last_update_date>2019-10-22 00:00:00</last_update_date>
<district_type>STATE_EXEC</district_type>
<subtype>EXEC</subtype>
<country>US</country>
<state>CA</state>
<city />
<district_id>CA</district_id>
<label>California</label>
<num_officials>17</num_officials>
<ocd_id>ocd-division/country:us/state:ca</ocd_id>
<data />
</district>
<district>
<id>875101</id>
<sk>875101</sk>
<valid_from>1977-05-18 00:00:00</valid_from>
<valid_to>None</valid_to>
<last_update_date>2019-10-23 00:00:00</last_update_date>
<district_type>NATIONAL_UPPER</district_type>
<subtype>UPPER</subtype>
<country>US</country>
<state>CA</state>
<city />
<district_id>CA</district_id>
<label>California</label>
<num_officials>2</num_officials>
<ocd_id>ocd-division/country:us/state:ca</ocd_id>
<data />
</district>
<district>
<id>901844</id>
<sk>757235</sk>
<valid_from>2023-01-03 00:00:00</valid_from>
<valid_to>2033-01-03 00:00:00</valid_to>
<last_update_date>2021-12-22 18:09:05.314860</last_update_date>
<district_type>NATIONAL_LOWER</district_type>
<subtype>LOWER</subtype>
<country>US</country>
<state>CA</state>
<city />
<district_id>40</district_id>
<label>California's 40th Congressional District</label>
<num_officials>1</num_officials>
<ocd_id>ocd-division/country:us/state:ca/cd:40</ocd_id>
<data />
</district>
<district>
<id>901897</id>
<sk>752732</sk>
<valid_from>2022-12-05 00:00:00</valid_from>
<valid_to>None</valid_to>
<last_update_date>2021-12-22 18:11:28.991809</last_update_date>
<district_type>STATE_UPPER</district_type>
<subtype>UPPER</subtype>
<country>US</country>
<state>CA</state>
<city />
<district_id>38</district_id>
<label>California State Senate district 38</label>
<num_officials>1</num_officials>
<ocd_id>ocd-division/country:us/state:ca/sldu:38</ocd_id>
<data />
</district>
<district>
<id>901972</id>
<sk>752685</sk>
<valid_from>2022-12-05 00:00:00</valid_from>
<valid_to>None</valid_to>
<last_update_date>2021-12-22 18:13:46.775290</last_update_date>
<district_type>STATE_LOWER</district_type>
<subtype>LOWER</subtype>
<country>US</country>
<state>CA</state>
<city />
<district_id>71</district_id>
<label>California Assembly district 71</label>
<num_officials>1</num_officials>
<ocd_id>ocd-division/country:us/state:ca/sldl:71</ocd_id>
<data />
</district>
<district>
<id>903439</id>
<sk>895322</sk>
<valid_from>2023-01-03 00:00:00</valid_from>
<valid_to>None</valid_to>
<last_update_date>2022-02-01 18:54:38.386223</last_update_date>
<district_type>LOCAL</district_type>
<subtype>COUNTY</subtype>
<country>US</country>
<state>CA</state>
<city>Orange County</city>
<district_id>3</district_id>
<label>Orange County Board of Supervisors district 3</label>
<num_officials>1</num_officials>
<ocd_id>ocd-division/country:us/state:ca/county:orange/council_district:3</ocd_id>
<data />
</district>
</districts>
<count>
<from>0</from>
<to>6</to>
<total>7</total>
</count>
</results>
</response>
/nonlegislative_district#
Introduction#
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.
Cost: 1 credit
Use location queries on this resource.
Response results include a list of district objects.
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/nonlegislative_district?\
lat=33.637562\
&lon=-117.606887\
&district_type=SCHOOL\
&format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/nonlegislative_district?\
lat=33.637562\
&lon=-117.606887\
&district_type=SCHOOL\
&format=xml\
&key={{customerId}}"
Response#
{
"response": {
"errors": [],
"messages": [],
"results": {
"districts": [
{
"id": 920897,
"sk": null,
"valid_from": "2021-01-01 00:00:00",
"valid_to": null,
"last_update_date": "2022-04-30 00:00:00",
"district_type": "SCHOOL",
"subtype": "UNIFIED",
"country": "US",
"state": "CA",
"city": "",
"district_id": "0607440",
"label": "Capistrano Unified School District",
"num_officials": 0,
"ocd_id": "ocd-division/country:us/state:ca/county:orange/school_district:capistrano_unified",
"data": {}
}
],
"count": {
"from": 0,
"to": 0,
"total": 1
}
}
}
}
<response>
<errors />
<messages />
<results>
<districts>
<district>
<id>920897</id>
<sk>None</sk>
<valid_from>2021-01-01 00:00:00</valid_from>
<valid_to>None</valid_to>
<last_update_date>2022-04-30 00:00:00</last_update_date>
<district_type>SCHOOL</district_type>
<subtype>UNIFIED</subtype>
<country>US</country>
<state>CA</state>
<city />
<district_id>0607440</district_id>
<label>Capistrano Unified School District</label>
<num_officials>0</num_officials>
<ocd_id>ocd-division/country:us/state:ca/county:orange/school_district:capistrano_unified</ocd_id>
<data />
</district>
</districts>
<count>
<from>0</from>
<to>0</to>
<total>1</total>
</count>
</results>
</response>
Attribution Requirements for Non-Legislative District Data:
Australian Census boundaries are licensed under the Creative Commons Attribution Australia License. Material that has not been modified or transformed must be cited using “Source: Australian Bureau of Statistics” or “Source: ABS”. Derivative material, such as modifications to text, deriving new statistics, calculating percentage changes, or creating graphs or charts must be attributed using “Based on Australian Bureau of Statistics data” or “Based on ABS data”.
Australian watershed boundaries are developed by Australian National University (ANU) and obtained through Geoscience Australia. Licensing is under Creative Commons Attribution Australia License. ANU has tried to make the information in this product as accurate as possible. However, it does not guarantee that the information is totally accurate or complete. Therefore you should not solely rely on this information when making a commercial decision. Users should also consider the scale and limitations of the source data on which it is based. The database is suitable for application at regional to continental scale. Finer scale data should be obtained for local scale analyses and assessment.
Canadian census and watershed boundaries are adapted from Statistics Canada. This does not constitute an endorsement by Statistics Canada of Cicero Web Services. Boundaries are reproduced and distributed on an “as is” basis with the permission of Statistics Canada. Use is subject to the Statistics Canada Open Licence Agreement.
/map#
Introduction#
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
Code |
Description |
|---|---|
width (optional) |
The width in pixels of the returned map image. |
height (optional) |
The height in pixels of the returned map image. |
fill_color (optional) |
The color of the district’s shape. |
fill_opacity (optional) |
The opacity of the district’s shape. |
boundary_width (optional) |
The width of the district’s outline. |
boundary_color (optional) |
The color of the district’s outline. |
boundary_line_join (optional) |
The type of line joins for the district’s outline. |
srs (optional) |
The EPSG code spatial reference system code for the map. |
format (optional) |
The format of the response: json, xml or image |
map_format (optional) |
The format of the map image. One of png (the default), png8, png32, png256 or jpeg. |
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/map/\
734?\
format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/map/\
734?\
format=xml\
&key={{customerId}}"
Response#
{
"response": {
"errors": [],
"messages": [],
"results": {
"maps": [
{
"extent": {
"x_min": -8963411.376635104,
"x_max": -8314397.281174287,
"y_min": 4797022.368711687,
"y_max": 5229698.432352231,
"srid": 3857
},
"img_src": "data:image/png;base64,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"
}
]
}
}
}
<response>
<errors />
<messages />
<results>
<maps>
<map>
<extent>
<x_min>-8963411.376635104</x_min>
<x_max>-8314397.281174287</x_max>
<y_min>4797022.368711687</y_min>
<y_max>5229698.432352231</y_max>
<srid>3857</srid>
</extent>
<img_src>data:image/png;base64,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</img_src>
</map>
</maps>
</results>
</response>
/election_event#
Introduction#
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
Code |
Description |
|---|---|
election_expire_date_after |
The earliest date an election is completed. Use today for elections completing today or later. Date should be specified in a YYYY-MM-DD format. |
election_expire_date_before |
The latest date an election is completed. Use tomorrow for elections completing before tomorrow. Date should be specified in a YYYY-MM-DD format. |
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/election_event?\
election_expire_date_on_or_after=today\
&election_expire_date_before=2024-04-01\
&format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/election_event?\
election_expire_date_on_or_after=today\
&election_expire_date_before=2024-04-01\
&format=xml\
&key={{customerId}}"
Response#
{
"response": {
"errors": [],
"messages": [],
"results": {
"election_events": [
{
"id": 25392,
"sk": 25391,
"valid_from": "2024-01-31 16:42:34",
"valid_to": null,
"last_update_date": "2024-01-31 16:46:01.775726",
"label": "Queensland Legislative Assembly By-election",
"remarks": "Ipswich West, Inala",
"election_date_text": "16 March 2024",
"election_expire_date": "2024-03-16 00:00:00",
"is_approximate": false,
"is_by_election": true,
"is_primary_election": false,
"is_runoff_election": false,
"is_referendum": false,
"is_local": false,
"is_state": true,
"is_national": false,
"is_transnational": false,
"urls": [
"https://en.wikipedia.org/wiki/2024_Ipswich_West_state_by-election"
],
"chambers": [
{
"legislature_update_date": "0001-01-01 04:56:02",
"official_count": 93,
"id": 9754,
"term_length": "4 years",
"term_limit": "Effective starting with the 2020 election, members of the Queensland Legislative Assembly now have fixed 4-year terms. Formerly, they were 3-year terms.\\n\\n",
"inauguration_rules": "",
"name_native_language": "",
"contact_phone": "",
"name_formal": "Queensland Legislative Assembly",
"election_frequency": "4 years",
"government": {
"name": "Queensland, Australia",
"type": "STATE",
"city": "",
"state": "QLD",
"country": {
"status": "UN Member State",
"name_short": "Australia",
"gmi_3": "AUS",
"valid_from": "0001-01-01 00:00:00",
"name_short_iso": "Australia",
"name_short_local": "Australia",
"valid_to": null,
"id": 285,
"sk": 13,
"name_short_un": "Australia",
"version": 2,
"fips": "AS",
"last_update_date": "2012-10-10 18:11:53.841914",
"iso_3": "AUS",
"iso_2": "AU",
"iso_3_numeric": 36,
"name_long_local": "Commonwealth of Australia",
"name_long": "Commonwealth of Australia"
},
"notes": "89-seat Legislative Assembly - unicameral, 3 year terms\\n\\nFull list with bios at:\\nhttp://en.wikipedia.org/wiki/Category:Members_of_the_Queensland_Legislative_Assembly"
},
"redistricting_rules": "",
"vacancy_rules": "",
"is_chamber_complete": true,
"contact_email": "",
"last_update_date": "2023-05-12 14:42:55.746603",
"remarks": "Single-member constituencies.\\n\\n",
"name": "Legislative Assembly",
"url": "https://www.parliament.qld.gov.au/",
"type": "LOWER",
"notes": "See https://www.parliament.qld.gov.au/explore/about-us/parliament-overview/queensland-electoral-system for information about switch to 4-year term.",
"has_geographic_representation": false,
"is_appointed": false,
"election_rules": "Section 80 of the Queensland Electoral Act 1992 states that an election must be held on a Saturday, and that the election campaign must run for a minimum of 26 or a maximum of 56 days following the issue of the writs including the day the writ drops and polling day. Five to seven days following the issue of the writs, the electoral roll is closed, which gives voters a final opportunity to enrol or to notify the Electoral Commission of Queensland of any changes in their place of residence.\\n\\nUnder current election rules, the date of the election is at the discretion of the Governor under advice from the Premier, although the leaders of the two largest parties support in principle a change to fixed four-year terms."
}
]
}
]
"count": {
"from": 0,
"to": 1,
"total": 1
}
}
}
}
<response>
<errors />
<messages />
<results>
<election_events>
<election_event>
<id>25392</id>
<sk>25391</sk>
<valid_from>2024-01-31 16:42:34</valid_from>
<valid_to>None</valid_to>
<last_update_date>2024-01-31 16:46:01.775726</last_update_date>
<label>Queensland Legislative Assembly By-election</label>
<remarks>Ipswich West, Inala</remarks>
<election_date_text>16 March 2024</election_date_text>
<election_expire_date>2024-03-16 00:00:00</election_expire_date>
<is_approximate>False</is_approximate>
<is_by_election>True</is_by_election>
<is_primary_election>False</is_primary_election>
<is_runoff_election>False</is_runoff_election>
<is_referendum>False</is_referendum>
<is_local>False</is_local>
<is_state>True</is_state>
<is_national>False</is_national>
<is_transnational>False</is_transnational>
<urls>
<url>https://en.wikipedia.org/wiki/2024_Ipswich_West_state_by-election</url>
</urls>
<chambers>
<chamber>
<legislature_update_date>0001-01-01 04:56:02</legislature_update_date>
<official_count>93</official_count>
<id>9754</id>
<term_length>4 years</term_length>
<term_limit>Effective starting with the 2020 election, members of the Queensland Legislative Assembly now have fixed 4-year terms. Formerly, they were 3-year terms.\n\n</term_limit>
<inauguration_rules />
<name_native_language />
<contact_phone />
<name_formal>Queensland Legislative Assembly</name_formal>
<election_frequency>4 years</election_frequency>
<government>
<name>Queensland, Australia</name>
<type>STATE</type>
<city />
<state>QLD</state>
<country>
<status>UN Member State</status>
<name_short>Australia</name_short>
<gmi_3>AUS</gmi_3>
<valid_from>0001-01-01 00:00:00</valid_from>
<name_short_iso>Australia</name_short_iso>
<name_short_local>Australia</name_short_local>
<valid_to>None</valid_to>
<id>285</id>
<sk>13</sk>
<name_short_un>Australia</name_short_un>
<version>2</version>
<fips>AS</fips>
<last_update_date>2012-10-10 18:11:53.841914</last_update_date>
<iso_3>AUS</iso_3>
<iso_2>AU</iso_2>
<iso_3_numeric>36</iso_3_numeric>
<name_long_local>Commonwealth of Australia</name_long_local>
<name_long>Commonwealth of Australia</name_long>
</country>
<notes>89-seat Legislative Assembly - unicameral, 3 year terms\n\nFull list with bios at:\nhttp://en.wikipedia.org/wiki/Category:Members_of_the_Queensland_Legislative_Assembly</notes>
</government>
<redistricting_rules />
<vacancy_rules />
<is_chamber_complete>True</is_chamber_complete>
<contact_email />
<last_update_date>2023-05-12 14:42:55.746603</last_update_date>
<remarks>Single-member constituencies.\n\n</remarks>
<name>Legislative Assembly</name>
<url>https://www.parliament.qld.gov.au/</url>
<type>LOWER</type>
<notes>See https://www.parliament.qld.gov.au/explore/about-us/parliament-overview/queensland-electoral-system for information about switch to 4-year term.</notes>
<has_geographic_representation>False</has_geographic_representation>
<is_appointed>False</is_appointed>
<election_rules>Section 80 of the Queensland Electoral Act 1992 states that an election must be held on a Saturday, and that the election campaign must run for a minimum of 26 or a maximum of 56 days following the issue of the writs including the day the writ drops and polling day. Five to seven days following the issue of the writs, the electoral roll is closed, which gives voters a final opportunity to enrol or to notify the Electoral Commission of Queensland of any changes in their place of residence.\n\nUnder current election rules, the date of the election is at the discretion of the Governor under advice from the Premier, although the leaders of the two largest parties support in principle a change to fixed four-year terms.</election_rules>
</chamber>
</chambers>
</election_event>
</election_events>
<count>
<from>0</from>
<to>1</to>
<total>1</total>
</count>
</results>
</response>
/redistricting_event#
Introduction#
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
Code |
Description |
|---|---|
begin_date_before |
The date a redistricting event was begun. Use today for redistricting events that have already started. Date should be specified in a YYYY-MM-DD format. |
complete_date_after |
The latest date a redistricting event is completed. Use tomorrow for redistricting events that are not yet completed. Date should be specified in a YYYY-MM-DD format. |
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/redistricting_event?\
begin_date_before=today\
&complete_date_after=tomorrow\
&format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/redistricting_event?\
begin_date_before=today\
&complete_date_after=tomorrow\
&format=xml\
&key={{customerId}}"
Response#
{
"response": {
"errors": [],
"messages": [],
"results": {
"redistricting_events": [
{
"id": 897,
"sk": 897,
"valid_from": "2022-09-26 20:12:37",
"valid_to": null,
"last_update_date": "2022-09-26 20:13:21.314779",
"label": "Macon-Bibb County Board of Commissioners Redistricting",
"state": "GA",
"remarks": "",
"begin_date": "2021-11-21",
"begin_date_is_approximate": false,
"complete_date": "2024-05-31",
"complete_date_is_approximate": true,
"email": null,
"urls": [],
"chambers": [
{
"legislature_update_date": null,
"official_count": 10,
"id": 9863,
"term_length": "4 years",
"term_limit": "The council is limited to 3 4-year terms\\n\\nThe mayor is limited to 2 4-year terms",
"inauguration_rules": "Fourth Tuesday in December following election",
"name_native_language": "",
"contact_phone": "",
"name_formal": "Macon-Bibb County Board of Commission",
"election_frequency": "4 years",
"government": {
"name": "Macon-Bibb County, Georgia, US",
"type": "LOCAL",
"city": "Macon",
"state": "GA",
"country": {
"status": "UN Member State",
"name_short": "United States",
"gmi_3": "USA",
"valid_from": "0001-01-01 00:00:00",
"name_short_iso": "United States",
"name_short_local": "United States",
"valid_to": null,
"id": 270,
"sk": 247,
"name_short_un": "United States of America",
"version": 1,
"fips": "US",
"last_update_date": "2012-10-10 17:29:57.613222",
"iso_3": "USA",
"iso_2": "US",
"iso_3_numeric": 840,
"name_long_local": "United States of America",
"name_long": "United States of America"
},
"notes": "Composed of nine Commissioners and the Mayor, the Macon-Bibb County Board of Commission is the legislative branch of the Macon-Bibb County Government. This body enacts the laws, ordinances, and resolutions for local consolidated government. Commissioners are elected every four years."
},
"redistricting_rules": "",
"vacancy_rules": "(a)\\nIn the event that the office of mayor or any commissioner shall become vacant for any cause whatsoever, the commission or those remaining shall, by resolution, order a special election to fill the balance of the unexpired term of that office.\\n(b)\\nIf, however, the vacancy in any commission seat occurs within 12 months of the expiration of the term of that office, the commission or those remaining may, within 20 days of the occurrence of the vacancy, appoint a successor for the remainder of the term.\\n(c)\\nIf, however, a vacancy in the office of the mayor occurs, the mayor pro tempore shall be acting mayor with all the powers and duties of that office until a successor is elected and qualified, and if the vacancy in the office of the mayor occurs within 12 months of expiration of the term of that office, the mayor pro tempore shall succeed to the office of the mayor for the remainder of the term and the commission seat of such person shall be filled in accordance with this section.",
"is_chamber_complete": true,
"contact_email": "",
"last_update_date": "2023-07-07 17:08:49.582496",
"remarks": "Mayor + 9 district commissioners",
"name": "Board of Commission",
"url": "https://www.maconbibb.us/commissioners/",
"type": "LOWER",
"notes": "",
"has_geographic_representation": false,
"is_appointed": false,
"election_rules": "Fourth Tuesday of May in presidential election years"
}
]
}
]
"count": {
"from": 0,
"to": 0,
"total": 1
}
}
}
}
<response>
<errors />
<messages />
<results>
<redistricting_events>
<redistricting_event>
<id>897</id>
<sk>897</sk>
<valid_from>2022-09-26 20:12:37</valid_from>
<valid_to>None</valid_to>
<last_update_date>2022-09-26 20:13:21.314779</last_update_date>
<label>Macon-Bibb County Board of Commissioners Redistricting</label>
<state>GA</state>
<remarks />
<begin_date>2021-11-21</begin_date>
<begin_date_is_approximate>False</begin_date_is_approximate>
<complete_date>2024-05-31</complete_date>
<complete_date_is_approximate>True</complete_date_is_approximate>
<email>None</email>
<urls />
<chambers>
<chamber>
<legislature_update_date>None</legislature_update_date>
<official_count>10</official_count>
<id>9863</id>
<term_length>4 years</term_length>
<term_limit>The council is limited to 3 4-year terms\n\nThe mayor is limited to 2 4-year terms</term_limit>
<inauguration_rules>Fourth Tuesday in December following election</inauguration_rules>
<name_native_language />
<contact_phone />
<name_formal>Macon-Bibb County Board of Commission</name_formal>
<election_frequency>4 years</election_frequency>
<government>
<name>Macon-Bibb County, Georgia, US</name>
<type>LOCAL</type>
<city>Macon</city>
<state>GA</state>
<country>
<status>UN Member State</status>
<name_short>United States</name_short>
<gmi_3>USA</gmi_3>
<valid_from>0001-01-01 00:00:00</valid_from>
<name_short_iso>United States</name_short_iso>
<name_short_local>United States</name_short_local>
<valid_to>None</valid_to>
<id>270</id>
<sk>247</sk>
<name_short_un>United States of America</name_short_un>
<version>1</version>
<fips>US</fips>
<last_update_date>2012-10-10 17:29:57.613222</last_update_date>
<iso_3>USA</iso_3>
<iso_2>US</iso_2>
<iso_3_numeric>840</iso_3_numeric>
<name_long_local>United States of America</name_long_local>
<name_long>United States of America</name_long>
</country>
<notes>Composed of nine Commissioners and the Mayor, the Macon-Bibb County Board of Commission is the legislative branch of the Macon-Bibb County Government. This body enacts the laws, ordinances, and resolutions for local consolidated government. Commissioners are elected every four years.</notes>
</government>
<redistricting_rules />
<vacancy_rules>(a)\nIn the event that the office of mayor or any commissioner shall become vacant for any cause whatsoever, the commission or those remaining shall, by resolution, order a special election to fill the balance of the unexpired term of that office.\n(b)\nIf, however, the vacancy in any commission seat occurs within 12 months of the expiration of the term of that office, the commission or those remaining may, within 20 days of the occurrence of the vacancy, appoint a successor for the remainder of the term.\n(c)\nIf, however, a vacancy in the office of the mayor occurs, the mayor pro tempore shall be acting mayor with all the powers and duties of that office until a successor is elected and qualified, and if the vacancy in the office of the mayor occurs within 12 months of expiration of the term of that office, the mayor pro tempore shall succeed to the office of the mayor for the remainder of the term and the commission seat of such person shall be filled in accordance with this section.</vacancy_rules>
<is_chamber_complete>True</is_chamber_complete>
<contact_email />
<last_update_date>2023-07-07 17:08:49.582496</last_update_date>
<remarks>Mayor + 9 district commissioners</remarks>
<name>Board of Commission</name>
<url>https://www.maconbibb.us/commissioners/</url>
<type>LOWER</type>
<notes />
<has_geographic_representation>False</has_geographic_representation>
<is_appointed>False</is_appointed>
<election_rules>Fourth Tuesday of May in presidential election years</election_rules>
</chamber>
</chambers>
</redistricting_event>
</redistricting_events>
<count>
<from>0</from>
<to>0</to>
<total>1</total>
</count>
</results>
</response>
/coverage#
Introduction#
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
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/coverage?\
format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/coverage?\
format=xml\
&key={{customerId}}"
Response#
{
"response": {
"errors": [],
"messages": [],
"results": {
"coverage": [
{
"name": "Australia",
"chambers": [
"House of Representatives",
"Senate"
],
"admin1": [
{
"name": "Tasmania, Australia",
"chambers": [
"House of Assembly",
"Legislative Council"
]
},
{
"name": "Western Australia",
"chambers": [
"Legislative Assembly",
"Legislative Council"
]
},
{
"name": "Northern Territory, Australia",
"chambers": [
"Legislative Assembly"
]
},
{
"name": "South Australia",
"chambers": [
"House of Assembly",
"Legislative Council"
]
},
{
"name": "Australian Capital Territory, Australia",
"chambers": [
"Legislative Assembly"
]
},
{
"name": "Queensland, Australia",
"chambers": [
"Legislative Assembly"
]
},
{
"name": "Victoria, Australia",
"chambers": [
"Legislative Assembly",
"Legislative Council"
]
},
{
"name": "New South Wales, Australia",
"chambers": [
"Legislative Assembly",
"Legislative Council"
]
}
],
"nonLegislative": {
"description": "Geographic divisions for which Cicero maintains boundaries but not elected officials.",
"types": [
"Census boundaries",
"Hydrologic boundaries from Geoscience Australia, the USGS, and Water Survey Canada"
]
}
}
]
}
}
}
<response>
<errors />
<messages />
<results>
<coverage>
<coverage>
<name>Australia</name>
<chambers>
<chamber>House of Representatives</chamber>
<chamber>Senate</chamber>
</chambers>
<admin1>
<admin1>
<name>Tasmania, Australia</name>
<chambers>
<chamber>House of Assembly</chamber>
<chamber>Legislative Council</chamber>
</chambers>
</admin1>
<admin1>
<name>Western Australia</name>
<chambers>
<chamber>Legislative Assembly</chamber>
<chamber>Legislative Council</chamber>
</chambers>
</admin1>
<admin1>
<name>Northern Territory, Australia</name>
<chambers>
<chamber>Legislative Assembly</chamber>
</chambers>
</admin1>
<admin1>
<name>South Australia</name>
<chambers>
<chamber>House of Assembly</chamber>
<chamber>Legislative Council</chamber>
</chambers>
</admin1>
<admin1>
<name>Australian Capital Territory, Australia</name>
<chambers>
<chamber>Legislative Assembly</chamber>
</chambers>
</admin1>
<admin1>
<name>Queensland, Australia</name>
<chambers>
<chamber>Legislative Assembly</chamber>
</chambers>
</admin1>
<admin1>
<name>Victoria, Australia</name>
<chambers>
<chamber>Legislative Assembly</chamber>
<chamber>Legislative Council</chamber>
</chambers>
</admin1>
<admin1>
<name>New South Wales, Australia</name>
<chambers>
<chamber>Legislative Assembly</chamber>
<chamber>Legislative Council</chamber>
</chambers>
</admin1>
</admin1>
<nonLegislative>
<description>Geographic divisions for which Cicero maintains boundaries but not elected officials.</description>
<types>
<type>Census boundaries</type>
<type>Hydrologic boundaries from Geoscience Australia, the USGS, and Water Survey Canada</type>
</types>
</nonLegislative>
</coverage>
</coverage>
</results>
</response>
account/credits_remaining#
Introduction#
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
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/account/credits_remaining?\
format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/account/credits_remaining?\
format=xml\
&key={{customerId}}"
Response#
{
"response": {
"errors": [],
"messages": [],
"results": {
"credit_balance": 0,
"overdraft_limit": 0,
"usable_batches": [
{
"credits_purchased": 10000,
"credits_remaining": 0,
"created": "2023-11-10 16:51:17.116718 Z",
"expiration_time": "2028-02-08",
"cost": "0.00",
"discount": "0.00"
}
]
}
}
}
<response>
<errors />
<messages />
<results>
<credit_balance>0</credit_balance>
<overdraft_limit>0</overdraft_limit>
<usable_batches>
<usable_batch>
<credits_purchased>10000</credits_purchased>
<credits_remaining>0</credits_remaining>
<created>2023-11-10 16:51:17.116718 Z</created>
<expiration_time>2028-02-08</expiration_time>
<cost>0.00</cost>
<discount>0.00</discount>
</usable_batch>
</usable_batches>
</results>
</response>
/account/usage#
Introduction#
Use the account/usage resource to get information about your API requests and credit usage by month for a range of months within the last year.nt
Specify your time range in a /YYYY-MM/to/YYYY-MM format.
Cost: 0 credits
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/account/usage/{YYYY-MM}/to/{YYYY-MM}?\
format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/account/usage/{YYYY-MM}/to/{YYYY-MM}?\
format=xml\
&key={{customerId}}"
Response#
{
"response": {
"errors": [],
"messages": [],
"results": [
{
"month": 1,
"year": 2024,
"count": 0,
"credits_used": 0,
"activity_types": []
}
]
}
}
<response>
<errors />
<messages />
<results>
<result>
<month>1</month>
<year>2024</year>
<count>0</count>
<credits_used>0</credits_used>
<activity_types />
</result>
</results>
</response>
/district_type#
Introduction#
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
The district_type resource returns a list of District Type objects in its results. You can use any of the name_short property values of these objects to filter resource responses by district.
Some common name_short values for legislative district types include:
NATIONAL_EXEC
NATIONAL_UPPER
NATIONAL_LOWER
STATE_EXEC
STATE_UPPER
STATE_LOWER
LOCAL_EXEC
LOCAL
Some common name_short values for non-legislative district types include:
SCHOOL
JUDICIAL
CENSUS
COUNTY
WATERSHED
The types of non-legislative districts tracked by Cicero vary regionally.
Try It Now#
curl -X GET "https://app.cicerodata.com/v3.1/district_type?\
format=json\
&key={{customerId}}"
curl -X GET "https://app.cicerodata.com/v3.1/district_type?\
format=xml\
&key={{customerId}}"
Response#
{
"response": {
"errors": [],
"messages": [],
"results": {
"district_types": [
{
"name_short": "CENSUS",
"name_long": "Census boundaries",
"is_legislative": false,
"notes": "Attribution is required for Australian and Canadian census data as indicated in the Creative Commons Attribution Australia License and Statistics Canada Open Licence Agreement, respectively.",
"acknowledgements": "Australian data obtained from Australian Bureau of Statistics.\r\n\r\nCanadian data adapted from Statistics Canada, 2011 Census Geography, 19 March 2012. This does not constitute an endorsement by Statistics Canada of this product."
},
{
"name_short": "COUNTY",
"name_long": "County, parish, borough, or other equivalent administrative region",
"is_legislative": false,
"notes": "In the US: county (most states), parish (Louisiana), or borough (Alaska)\r\n\r\nIn Canada (coming soon): Census division, defined by Statistics Canada as a \"group of neighbouring municipalities joined together for the purposes of regional planning and managing common services (such as police or ambulance services). These groupings are established under laws in effect in certain provinces of Canada. For example, a census division might correspond to a county, une municipalité régionale de comté or a regional district. In other provinces and the territories where laws do not provide for such areas, Statistics Canada defines equivalent areas for statistical reporting purposes in cooperation with these provinces and territories.\"",
"acknowledgements": "Canadian data adapted from Statistics Canada, 2011 Census Geography, 5 July 2012. This does not constitute an endorsement by Statistics Canada of this product."
},
{
"name_short": "JUDICIAL",
"name_long": "Judicial district",
"is_legislative": false,
"notes": "",
"acknowledgements": ""
},
{
"name_short": "LOCAL",
"name_long": "Ward or other local district",
"is_legislative": true,
"notes": "",
"acknowledgements": ""
},
{
"name_short": "LOCAL_EXEC",
"name_long": "Municipality / county (or equivalent)",
"is_legislative": true,
"notes": "",
"acknowledgements": ""
},
{
"name_short": "NATIONAL_EXEC",
"name_long": "Country",
"is_legislative": true,
"notes": "",
"acknowledgements": ""
},
{
"name_short": "NATIONAL_LOWER",
"name_long": "National lower house district",
"is_legislative": true,
"notes": "",
"acknowledgements": ""
},
{
"name_short": "NATIONAL_UPPER",
"name_long": "National upper house district",
"is_legislative": true,
"notes": "",
"acknowledgements": ""
},
{
"name_short": "POLICE",
"name_long": "Police district",
"is_legislative": false,
"notes": "",
"acknowledgements": ""
},
{
"name_short": "SCHOOL",
"name_long": "School district",
"is_legislative": false,
"notes": "",
"acknowledgements": ""
},
{
"name_short": "STATE_EXEC",
"name_long": "State / province / territory",
"is_legislative": true,
"notes": "",
"acknowledgements": ""
},
{
"name_short": "STATE_LOWER",
"name_long": "Subnational lower district",
"is_legislative": true,
"notes": "",
"acknowledgements": ""
},
{
"name_short": "STATE_UPPER",
"name_long": "Subnational upper district",
"is_legislative": true,
"notes": "",
"acknowledgements": ""
},
{
"name_short": "TRANSNATIONAL_EXEC",
"name_long": "",
"is_legislative": true,
"notes": "",
"acknowledgements": ""
},
{
"name_short": "TRANSNATIONAL_LOWER",
"name_long": "",
"is_legislative": true,
"notes": "",
"acknowledgements": ""
},
{
"name_short": "TRANSNATIONAL_UPPER",
"name_long": "",
"is_legislative": true,
"notes": "",
"acknowledgements": ""
},
{
"name_short": "VOTING",
"name_long": "Voting district",
"is_legislative": false,
"notes": "",
"acknowledgements": ""
},
{
"name_short": "WATERSHED",
"name_long": "Hydrologic boundaries from Geoscience Australia, the USGS, and Water Survey Canada",
"is_legislative": false,
"notes": "",
"acknowledgements": ""
}
]
}
}
}
<response>
<errors />
<messages />
<results>
<district_types>
<district_type>
<name_short>CENSUS</name_short>
<name_long>Census boundaries</name_long>
<is_legislative>False</is_legislative>
<notes>Attribution is required for Australian and Canadian census data as indicated in the Creative Commons Attribution Australia License and Statistics Canada Open Licence Agreement, respectively.</notes>
<acknowledgements>Australian data obtained from Australian Bureau of Statistics. Canadian data adapted from Statistics Canada, 2011 Census Geography, 19 March 2012. This does not constitute an endorsement by Statistics Canada of this product.</acknowledgements>
</district_type>
<district_type>
<name_short>COUNTY</name_short>
<name_long>County, parish, borough, or other equivalent administrative region</name_long>
<is_legislative>False</is_legislative>
<notes>In the US: county (most states), parish (Louisiana), or borough (Alaska) In Canada (coming soon): Census division, defined by Statistics Canada as a "group of neighbouring municipalities joined together for the purposes of regional planning and managing common services (such as police or ambulance services). These groupings are established under laws in effect in certain provinces of Canada. For example, a census division might correspond to a county, une municipalité régionale de comté or a regional district. In other provinces and the territories where laws do not provide for such areas, Statistics Canada defines equivalent areas for statistical reporting purposes in cooperation with these provinces and territories."</notes>
<acknowledgements>Canadian data adapted from Statistics Canada, 2011 Census Geography, 5 July 2012. This does not constitute an endorsement by Statistics Canada of this product.</acknowledgements>
</district_type>
<district_type>
<name_short>JUDICIAL</name_short>
<name_long>Judicial district</name_long>
<is_legislative>False</is_legislative>
<notes />
<acknowledgements />
</district_type>
<district_type>
<name_short>LOCAL</name_short>
<name_long>Ward or other local district</name_long>
<is_legislative>True</is_legislative>
<notes />
<acknowledgements />
</district_type>
<district_type>
<name_short>LOCAL_EXEC</name_short>
<name_long>Municipality / county (or equivalent)</name_long>
<is_legislative>True</is_legislative>
<notes />
<acknowledgements />
</district_type>
<district_type>
<name_short>NATIONAL_EXEC</name_short>
<name_long>Country</name_long>
<is_legislative>True</is_legislative>
<notes />
<acknowledgements />
</district_type>
<district_type>
<name_short>NATIONAL_LOWER</name_short>
<name_long>National lower house district</name_long>
<is_legislative>True</is_legislative>
<notes />
<acknowledgements />
</district_type>
<district_type>
<name_short>NATIONAL_UPPER</name_short>
<name_long>National upper house district</name_long>
<is_legislative>True</is_legislative>
<notes />
<acknowledgements />
</district_type>
<district_type>
<name_short>POLICE</name_short>
<name_long>Police district</name_long>
<is_legislative>False</is_legislative>
<notes />
<acknowledgements />
</district_type>
<district_type>
<name_short>SCHOOL</name_short>
<name_long>School district</name_long>
<is_legislative>False</is_legislative>
<notes />
<acknowledgements />
</district_type>
<district_type>
<name_short>STATE_EXEC</name_short>
<name_long>State / province / territory</name_long>
<is_legislative>True</is_legislative>
<notes />
<acknowledgements />
</district_type>
<district_type>
<name_short>STATE_LOWER</name_short>
<name_long>Subnational lower district</name_long>
<is_legislative>True</is_legislative>
<notes />
<acknowledgements />
</district_type>
<district_type>
<name_short>STATE_UPPER</name_short>
<name_long>Subnational upper district</name_long>
<is_legislative>True</is_legislative>
<notes />
<acknowledgements />
</district_type>
<district_type>
<name_short>TRANSNATIONAL_EXEC</name_short>
<name_long />
<is_legislative>True</is_legislative>
<notes />
<acknowledgements />
</district_type>
<district_type>
<name_short>TRANSNATIONAL_LOWER</name_short>
<name_long />
<is_legislative>True</is_legislative>
<notes />
<acknowledgements />
</district_type>
<district_type>
<name_short>TRANSNATIONAL_UPPER</name_short>
<name_long />
<is_legislative>True</is_legislative>
<notes />
<acknowledgements />
</district_type>
<district_type>
<name_short>VOTING</name_short>
<name_long>Voting district</name_long>
<is_legislative>False</is_legislative>
<notes />
<acknowledgements />
</district_type>
<district_type>
<name_short>WATERSHED</name_short>
<name_long>Hydrologic boundaries from Geoscience Australia, the USGS, and Water Survey Canada</name_long>
<is_legislative>False</is_legislative>
<notes />
<acknowledgements />
</district_type>
</district_types>
</results>
</response>
/version#
Introduction#
Use the version resource to get the current version of the API.
Cost: 0 credits
Try It Now#
curl -X GET "https://app.cicerodata.com/version\
?format=json"
curl -X GET "https://app.cicerodata.com/version\
?format=xml"
Response#
{
"response": {
"errors": [],
"messages": [],
"results": {
"version": "3.1"
}
}
}
<response>
<errors />
<messages />
<results>
<version>3.1</version>
</results>
</response>
Response Fields#
Service Level Response Fields#
Output Name |
Description |
|---|---|
errors |
If the request encountered an error or errors, details about the error(s) will be contained in this field, as an array of strings. |
messages |
Contains the resources matching the request query, if any. The structure of this object depends on the type of resource being queried. Refer to the documentation for the endpoint you are querying and the section on Response Objects for details. |
results |
Contains additional information about the outcome of a request that is not an error and not part of a query result, as an array of strings. Currently, this field is unused by the data endpoints and will always be an empty array. |
Record Level Response Fields#
Official object
Official objects are a component of responses from the official resource.
Output Name |
Description |
|---|---|
id |
The Cicero database ID for this official. Changes after each edit; for a persistent ID, see sk. |
sk |
The surrogate key for an official. Remains the same for an individual through different districts, chambers, and discontinuous terms. |
first_name |
First name of the official. Sometimes, an official will have a preferred_name that they are more commonly known by. |
last_name |
Last name of the official. |
middle_initial |
Middle name or initial of the official. |
preferred_name |
A name commonly used instead of the official’s given first name. This property has a value only if it differs from the first_name. |
salutation |
Official’s formal salutation. Some assemblies use formal titles such as “Honorable”. |
name_suffix |
Name suffix of the official (e.g., “Jr.”, “III”, “Ph.D.”). |
party |
Political party designation of the official. Might be “Nonpartisan” in cases where the government specifically uses that term. |
titles |
A list of any titles that the official holds. Typically, these are determined at an early meeting of the chamber. Titles are different than and in addition to the role (e.g., President, Senator) that the official was elected to. |
office |
An office object with information about the official’s country, chamber, government, and role. |
addresses |
A list of address objects with the official’s contact information, such as mailing address, phone, and fax. |
email_addresses |
A list of the official’s email addresses. |
urls |
A list of the official’s government web page URLs. |
web_form_url |
A web form URL for contacting the official. |
photo_origin_url |
A URL for a headshot photo of the official. See note 1, below. |
photo_cropping |
For photos that are zoomed out or off center, an object of the form {x, y, width, height, origWidth, origHeight} specifying the location (from top left) and dimensions of a bounding box that defines a headshot within the official photo. If no bounding box is defined (e.g. if the original photo is a well-framed headshot), this field will be null. See note 2, below. |
identifiers |
A list of identifier objects with information like social media accounts. |
notes |
A list of descriptive information about the official, including a biography and a birthdate. |
valid_from |
Date the official was inaugurated in this office. Changes with redistricting or election to a new office, but not when an incumbent starts a consecutive term. |
valid_to |
Date the official’s term in office expires. This date would be extended if the official wins re-election. |
last_update_date |
Date the Cicero research team last made changes to this official’s information. |
committees |
A list of the committees of which the official is a member. See Committee Membership object documentation. |
term_end_date |
Deprecated. Use valid_to instead. |
initial_term_start_date |
Deprecated. Use valid_from instead. |
current_term_start_date |
Deprecated. Use valid_from instead. |
nickname |
Deprecated. Use preferred_name instead. |
Note 1
In all cases where it is filled out, the photo_origin_url provides a direct link to an image file of an official’s headshot photo. Whenever possible, we use links to photos hosted on official sites operated by the government body of which the official is a member. However, there are rare cases where this is not possible. Sometimes, there is no official government site containing a headshot photo of the official. In this case, we try to locate a photo from another source, such as the Congressional Biographical Directory. In other cases, an official site with photos may exist, but it may not be possible for us to provide direct links to the photos. In these cases, we copy and host the photos ourselves. Whenever we host a photo ourselves, we obtain permission from the relevant government body before copying and hosting their photos. If a photo is hosted by Cicero, the URL will start with: https://s3.amazonaws.com/cicero-media-files/ or https://cicero-media-files.s3.amazonaws.com/.
Note 2
The photo_cropping field contains a JSON object with properties x, y, width, height, origWidth, and origHeight. These parameters can be used to calculate CSS that will display the image at photo_origin_url cropped and scaled to fit in a fixed-size element. x and y are the coordinates of the top left corner of the cropping box, width and height are the dimensions of the cropping box, and origWidth and origHeight are the dimensions of the full-sized original image.
The example CSS is a template for calculating a style definition. The quantities in brackets must be calculated for each image based on the photo_cropping parameters and the size of the intended container (displayHeight and displayWidth). The example scales to the container height, which means the width could be more or less than the container size, depending on the dimensions of the cropping box. The calculations could be adapted to scale to the display width instead, but not both, since that could result in the image being stretched or squashed.
In cases where the original image is a standard headshot and no cropping is needed, the photo_cropping field will be null and the style should use background-size: cover; and background-position: center;.
Abbreviated Official object
Output Name |
Description |
|---|---|
first_name |
First name of the official. Sometimes, an official will have a preferred_name that they are more commonly known by. |
last_name |
Last name of the official. |
middle_initial |
Middle name or initial of the official. |
preferred_name |
A name commonly used instead of the official’s given first name. This property has a value only if it differs from the first_name. |
salutation |
Official’s formal salutation. Some assemblies use formal titles such as “Honorable”. |
name_suffix |
Name suffix of the official (e.g., “Jr.”, “III”, “Ph.D.”). |
sk |
The surrogate key for the official. |
party |
Political party designation of the official. Might be “Nonpartisan” in cases where the government specifically uses that term. |
district |
An abbreviated district object containing only district_id, district_type__name_short, subtype, and label |
state |
The state, province, or region of the official’s district. |
chamber__name_formal |
The formal name of the official’s chamber. |
title |
The primary title the official holds. |
addresses |
A list of address objects with the official’s contact information, such as mailing address, phone, and fax. |
email_addresses |
A list of the official’s email addresses. |
phone_1 |
The primary phone number for the official’s primary address. |
phone_2 |
The secondary phone number for the official’s primary address. |
photo_origin_url |
A URL for a headshot photo of the official. |
web_form_url |
A web form URL for contacting the official. |
identifiers |
A list of abbreviated identifier objects containing only identifier_type and identifier_value for official Facebook and Twitter accounts. |
valid_from |
Date the official was inaugurated in this office. Changes with redistricting or election to a new office, but not when an incumbent starts a consecutive term. |
valid_to |
Date the official’s term in office expires. This date would be extended if the official wins re-election. |
Office object
Office objects are a component of responses from the official resource.
Output Name |
Description |
|---|---|
title |
The role of this office. This is the position that an candidate for office is listed for on an election ballot. |
chamber |
A chamber object for the chamber that this office serves within. |
district |
A district object for the constituency of this office. |
representing_country |
A country object for the country of this office’s government. |
representing_state |
The state, province, or other region that this office serves. |
representing_city |
The city that this office serves. |
id |
Deprecated. Use id on the Official object |
sk |
Deprecated. Use sk on the Official object |
valid_from |
Deprecated. Use valid_from on the Offical object |
valid_to |
Deprecated. Use valid_to on the Offical object |
last_update_date |
Deprecated. Use last_update_date on the Official object |
election_rules |
Deprecated. Use election_rules on the Chamber object |
notes |
Deprecated. |
Address object
Address objects are a component of responses from the official resource. Primary address objects are listed first and usually contain Capitol or official government offices for the legislature. Secondary address objects are listed second and usually contain district or home offices.
Output Name |
Description |
|---|---|
address_1 |
The first line of the street address. |
address_2 |
The second line of the street address. |
address_3 |
The third line of the street address. |
state |
The state, province, or other region of the address. |
postal_code |
The postal code for the address. |
phone_1 |
The primary phone number for contacting the address. |
phone_2 |
The secondary phone number for contacting the address. |
fax_1 |
The primary fax number for the address. |
fax_2 |
The secondary fax number for the address. |
county |
Deprecated. |
Identifier object
Output Name |
Description |
|---|---|
identifier_type |
The platform referred to by the identifier (see a list of identifier types, below). |
id |
The Cicero database ID for this identifier. |
identifier_value |
The identifying value for the official on this type of platform. Could be either a profile ID or a full URL. |
official |
Deprecated. Use id on the Official object |
valid_from |
Deprecated. |
valid_to |
Deprecated. |
last_update_date |
Deprecated. |
sk |
Deprecated. |
version |
Deprecated. |
Common Identifier Types in Cicero:
identifier_type |
Description |
Platform URL |
|---|---|---|
The full Facebook page URL of an official’s personal profile. |
||
FACEBOOK-CAMPAIGN |
The full Facebook page URL for an official’s campaign profile. |
|
FACEBOOK-OFFICIAL |
The full Facebook page URL for an official’s government profile. |
|
VOTESMART |
The Vote Smart profile ID of an official. |
|
The Twitter handle of an official. |
||
The full LinkedIn profile URL of an official. |
||
YOUTUBE |
The YouTube user ID or channel ID for an official. |
|
The Instagram handle for an official. |
||
INSTAGRAM-CAMPAIGN |
The Instagram handle for an official’s campaign. |
|
RSS |
The RSS feed URL for an official. |
Unique URL |
FLICKR |
The Flickr profile ID of an official. |
|
BIOGUIDE |
The Congressional Biographical Directory profile ID for an official. |
|
GOVTRACK |
The GovTrack profile ID for an official. |
|
FEC |
The Federal Election Committee profile ID for an official or campaign committee. |
|
CRP |
The OpenSecrets.org Center for Responsive Politics profile ID for an official. |
Committee Membership object
Committee Membership objects are a component of responses from the official resource, identifying the committees on which an official serves and their position within each committee.
Output Name |
Description |
|---|---|
name |
Name of the committee. |
urls |
A list of the committee’s web page URLs. |
committee_identifiers |
A list of identifier objects with information like social media accounts. Note that fields marked deprecated in the identifier object documentation are excluded here. |
position |
The official’s position within the committee, e.g. “Chair”. For members with no special position this field will be blank. |
District object
District objects are a component of responses from the official, legislative_district, and nonlegislative_district resources.
Output Name |
Description |
|---|---|
id |
The Cicero database ID for this district. This field is persistent for a given District, but this does not imply that the remainder of the response payload will never change. For example, a correction to the district boundary will change the response payload but will not change the ID. On the other hand, a boundary change due to a legal event such as an annexation or redistricting will result in a new District with a new ID (and appropriate adjustments to the valid_to field, if necessary). |
sk |
The surrogate key for the district. Provided for API uniformity. For this resource, the SK is equivalent to the ID. |
ocd_id |
The Open Civic Data Identifier for the district. Provides a standardized way of specifying and describing a geographic political division. |
label |
Descriptive text associated with a district_id, such as the label for the district (e.g. “5th Ward”), or a full label for the district (e.g. “Sealaska Alaska Native Regional Corporation”). |
district_type |
The level of government the district represents. See the district_type metadata endpoint for a list of possibilities. |
subtype |
An additional categorization within district_type. |
district_id |
The identifying code for the district within its delegation or district type. For example, a legislative delegation’s 5th district would probably have a district_id of “5”. Non-legislative districts might have an ID assigned by the managing agency (e.g., US Census Block Groups have a GEOID). |
city |
The city the district represents, if the district_type is LOCAL or LOCAL_EXEC. |
state |
The state, province, or region the district is within. |
country |
The country the district is within. Uses the ISO 2 country code. |
num_officials |
The number of elected officials that hold offices representing this district. |
valid_from |
The date the district was established. Usually, this is the date of the last redistricting. |
valid_to |
The date when the district’s boundaries are expected to be changed. Usually, this is the date of the next redistricting. |
last_update_date |
Date the Cicero research team last made changes to this district’s boundary information. |
data |
Deprecated. |
Chamber object
Chamber objects are a component of responses from the official and election_event resources.
Output Name |
Description |
|---|---|
id |
The Cicero database ID for the chamber. Changes after each edit; not persistent. |
name |
Informal name of the chamber in English. |
name_formal |
English formal name of the chamber. |
name_native_language |
Name of the chamber in the government’s official language. |
government |
A government object for the government this chamber is part of. |
type |
Governmental level of the chamber. |
official_count |
The number of officials serving in the chamber. |
term_length |
The length of time for each term that officials serve in the chamber. |
term_limit |
The maximum number of terms officials within the chamber can serve. |
election_frequency |
The length of time between elections with candidates for the chamber on the ballot. Shorter than term_length in chambers with staggered elections. |
election_rules |
A description of when elections take place. |
vacancy_rules |
The process of how vacancies within the chamber are filled. |
redistricting_rules |
The process of redistricting for the chamber. |
inauguration_rules |
The process for inaugurating officials within the chamber. |
url |
URL to the official webpage of the chamber. |
contact_phone |
A general phone number for contacting the chamber. |
contact_email |
A general email address for contacting the chamber. |
is_appointed |
Whether officials in this chamber are appointed rather than elected. |
remarks |
Notable quirks or facts related to the chamber. |
last_update_date |
Date the Cicero research team last made changes to this district’s information. |
legislature_update_date |
Deprecated. |
is_chamber_complete |
Deprecated. |
has_geographic_representation |
Deprecated. |
notes |
Deprecated. |
Government object
Government objects are a component of responses from the official and election_event resources.
Output Name |
Description |
|---|---|
name |
The formal name of the government. |
type |
A category describing the level of government. |
city |
The city that the government governs. |
state |
The state, province, or region that the government governs. |
country |
A country object for the government’s country. |
notes |
Deprecated. |
Country object
Country objects are a component of responses from the official and election_event resources.
Output Name |
Description |
|---|---|
id |
The Cicero database ID for the country. Changes after each edit; for a persistent ID, see sk. |
sk |
The surrogate key for the country. |
status |
The parent organization (e.g., “UN Member State”) or state on which the given Country is dependent (e.g., “Oversea Department of France”). |
name_short |
Short, common name for the country in English. |
name_short_iso |
Short name (in English) for the country specified in the ISO-3166 standard. |
name_short_local |
Short, common name for the country in the local language. |
name_short_un |
United Nations short name for the country. |
name_long |
Long name for the country in English. |
name_long_local |
Long name for the country in the local language. |
gmi_3 |
Three-letter Global Mapping International (GMI) country/territory code for the country. |
iso_2 |
Two-letter ISO 3166-1 alpha-2 standard code for the country. |
iso_3 |
Three-letter ISO 3166-1 alpha-3 standard code for the country. |
iso_3_numeric |
Three-digit ISO 3166-1 numeric standard code for the country. |
fips |
Two-letter U.S. Federal Information Processing Standard No. |
last_update_date |
Date the Cicero research team last made changes to the country’s information. |
valid_from |
Deprecated. |
valid_to |
Deprecated. |
version |
Deprecated. |
Election Event object
Output Name |
Description |
|---|---|
id |
The Cicero database ID for the election event. Changes after each edit; for a persistent ID, see sk. |
sk |
The surrogate key for the election event. |
label |
The name of the election. |
chambers |
A list of chamber objects for chambers with members up for election. |
election_expire_date |
The date when voting in the election completes. Some elections span several days; this will be the last day. |
election_date_text |
A description of the date or dates that an election is being held. |
is_approximate |
Whether the election event’s election_expire_date is not accurate or precise to the day. |
is_local |
Whether the election is for an office of local government (e.g., a municipal, county, or town election). |
is_state |
Whether the election is for an office of regional government (e.g., sub-national state, provincial, or prefecture election). |
is_national |
Whether the election is for an office of the nation state. |
is_by_election |
Whether the election is a special election that falls outside the regular calendar. |
is_referendum |
Whether the election event is specifically about a referendum on the ballot. |
is_primary_election |
Whether the election is a primary election that precedes the general election. |
is_runoff_election |
Whether the election is a second, third, or later election used for deciding between the top candidates in earlier elections. |
is_transnational |
Whether the election is for an office of a trans-national institution. |
urls |
A list of URL strings for pages with more information about the election. |
remarks |
Specific details about the election that describe the event. |
last_update_date |
Date the Cicero research team last made changes to the election’s information. |
valid_from |
Deprecated |
valid_to |
Deprecated |
Redistricting Event object
Output Name |
Description |
|---|---|
id |
The Cicero database ID for the redistricting event. Changes after each edit; for a persistent ID, see sk. |
sk |
The surrogate key for the redistricting event. |
label |
The name of the redistricting event. |
state |
The state or country subdivision where the redistricting event occurred. |
chambers |
A list of chamber objects for chambers with modified districts in the redistricting event. |
begin_date |
The date when the redistricting event started. |
begin_date_is_approximate |
Whether the redistricting event’s begin_date is not accurate or precise to the day. |
complete_date |
The date when the redistricting event completed. |
complete_date_is_approximate |
Whether the redistricting event’s complete_date is not accurate or precise to the day. |
urls |
A list of URL strings for pages with more information about the election. |
remarks |
Specific details about the election that describe the event. |
last_update_date |
Date the Cicero research team last made changes to the election’s information. |
District Type object
Output Name |
Description |
|---|---|
name_short |
The code used for filtering responses by district type. Formatted in ALL_CAPS with an underscore. |
name_long |
A description of the district type. |
is_legislative |
Whether the districts of this type are legislative. |
notes |
Deprecated |
acknowledgements |
Deprecated |