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:

  1. API Key authentication

  2. 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:

  1. Transnational

  2. National

  3. State

  4. Local

Within each level, the ordering is:

  1. Executive

  2. Upper

  3. 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#

  • GET JSON
  • GET XML
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#

  • GET JSON
  • GET XML
{
    "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&#8217;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 &#8211; Iraq, overseeing all combat operations in the country. \n\nAfter a tour as the Army&#8217;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#

  • GET JSON
  • GET XML
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#

  • GET JSON
  • GET XML
{
    "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#

  • GET JSON
  • GET XML
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#

  • GET JSON
  • GET XML
{
    "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#

  • GET JSON
  • GET XML
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#

  • GET JSON
  • GET XML
{
    "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#

  • GET JSON
  • GET XML
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#

  • GET JSON
  • GET XML
{
    "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#

  • GET JSON
  • GET XML
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#

  • GET JSON
  • GET XML
{
    "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#

  • GET JSON
  • GET XML
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#

  • GET JSON
  • GET XML
{
    "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#

  • GET JSON
  • GET XML
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#

  • GET JSON
  • GET XML
{
    "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#

  • GET JSON
  • GET XML
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#

  • GET JSON
  • GET XML
{
    "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#

  • GET JSON
  • GET XML
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#

  • GET JSON
  • GET XML
{
    "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#

  • GET JSON
  • GET XML
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#

  • GET JSON
  • GET XML
{
    "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&#233; r&#233;gionale de comt&#233; 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#

  • GET JSON
  • GET XML
curl -X GET "https://app.cicerodata.com/version\
?format=json"
curl -X GET "https://app.cicerodata.com/version\
?format=xml"

Response#

  • GET JSON
  • GET XML
{
    "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

FACEBOOK

The full Facebook page URL of an official’s personal profile.

https://www.facebook.com

FACEBOOK-CAMPAIGN

The full Facebook page URL for an official’s campaign profile.

https://www.facebook.com

FACEBOOK-OFFICIAL

The full Facebook page URL for an official’s government profile.

https://www.facebook.com

VOTESMART

The Vote Smart profile ID of an official.

https://www.votesmart.org

TWITTER

The Twitter handle of an official.

https://www.twitter.com

LINKEDIN

The full LinkedIn profile URL of an official.

https://www.linkedin.com

YOUTUBE

The YouTube user ID or channel ID for an official.

https://www.youtube.com

INSTAGRAM

The Instagram handle for an official.

https://www.instagram.com

INSTAGRAM-CAMPAIGN

The Instagram handle for an official’s campaign.

https://www.instagram.com

RSS

The RSS feed URL for an official.

Unique URL

FLICKR

The Flickr profile ID of an official.

https://www.flickr.com

BIOGUIDE

The Congressional Biographical Directory profile ID for an official.

http://bioguide.congress.gov

GOVTRACK

The GovTrack profile ID for an official.

https://www.govtrack.us

FEC

The Federal Election Committee profile ID for an official or campaign committee.

https://www.fec.gov/

CRP

The OpenSecrets.org Center for Responsive Politics profile ID for an official.

https://www.opensecrets.org

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