# Find election events 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 Endpoint: GET /election_event ## Header parameters: - `Accept` (string, required) Format of the response. Enum: "application/json", "*/*" - `Content-Type` (string, required) Format of the request. Enum: "application/json", "application/xml" ## Query parameters: - `format` (string) Specify the desired format of the response. Enum: "json", "xml" - `customer_id` (string, required) Required. The License Key issued by Melissa. Example: "{REPLACE-WITH-YOUR-LICENSE-KEY}" - `election_expire_date_on_or_after` (string) 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. Example: "today" - `election_expire_date_before` (string) The latest date an election is completed. Use tomorrow for elections completing before tomorrow. Date should be specified in a YYYY-MM-DD format. - `max` (integer) The maximum number of objects to return. - `offset` (integer) Number of items to skip in the response, starting from the beginning of the list. - `key` (string) The License Key issued by Melissa. ## Response 200 fields (application/json): - `response` (object) - `response.errors` (array) If the request encountered an error or errors, details about the error(s) will be contained in this field. - `response.messages` (array) Contains the resources matching the request query, if any. - `response.results` (object) Contains additional information about the outcome of a request that is not an error and not part of a query result. - `response.results.election_events` (array) - `response.results.election_events.id` (number) The Cicero database ID for the election event. Changes after each edit; for a persistent ID, see sk. - `response.results.election_events.sk` (number) The surrogate key for the election event. - `response.results.election_events.last_update_date` (string) Date the Cicero research team last made changes to the election's information. - `response.results.election_events.label` (string) The name of the election. - `response.results.election_events.remarks` (string) Specific details about the election that describe the event. - `response.results.election_events.election_date_text` (string) A description of the date or dates that an election is being held. - `response.results.election_events.election_expire_date` (string,null) The date when voting in the election completes. Some elections span several days; this will be the last day. - `response.results.election_events.is_approximate` (boolean) Whether the election event's election_expire_date is not accurate or precise to the day. - `response.results.election_events.is_by_election` (boolean) Whether the election is a special election that falls outside the regular calendar. - `response.results.election_events.is_primary_election` (boolean) Whether the election is a primary election that precedes the general election. - `response.results.election_events.is_runoff_election` (boolean) Whether the election is a second, third, or later election used for deciding between the top candidates in earlier elections. - `response.results.election_events.is_referendum` (boolean) Whether the election event is specifically about a referendum on the ballot. - `response.results.election_events.is_local` (boolean) Whether the election is for an office of local government (e.g., a municipal, county, or town election). - `response.results.election_events.is_state` (boolean) Whether the election is for an office of regional government (e.g., sub-national state, provincial, or prefecture election). - `response.results.election_events.is_national` (boolean) Whether the election is for an office of the nation state. - `response.results.election_events.is_transnational` (boolean) Whether the election is for an office of a trans-national institution. - `response.results.election_events.urls` (array) A list of URL strings for pages with more information about the election. - `response.results.election_events.chambers` (array) A list of chamber objects for chambers with members up for election. - `response.results.election_events.chambers.official_count` (number,null) The number of officials serving in the chamber. - `response.results.election_events.chambers.id` (number,null) The Cicero database ID for the chamber. Changes after each edit; not persistent. - `response.results.election_events.chambers.term_length` (string) The length of time for each term that officials serve in the chamber. - `response.results.election_events.chambers.term_limit` (string) The maximum number of terms officials within the chamber can serve. - `response.results.election_events.chambers.inauguration_rules` (string) The process for inaugurating officials within the chamber. - `response.results.election_events.chambers.name_native_language` (string) Name of the chamber in the government's official language. - `response.results.election_events.chambers.contact_phone` (string) A general phone number for contacting the chamber. - `response.results.election_events.chambers.name_formal` (string) English formal name of the chamber. - `response.results.election_events.chambers.election_frequency` (string) The length of time between elections with candidates for the chamber on the ballot. Shorter than term_length in chambers with staggered elections. - `response.results.election_events.chambers.government` (object) - `response.results.election_events.chambers.government.name` (string) The formal name of the government. - `response.results.election_events.chambers.government.type` (string) A category describing the level of government. - `response.results.election_events.chambers.government.city` (string) The city that the government governs. - `response.results.election_events.chambers.government.state` (string) The state, province, or region that the government governs. - `response.results.election_events.chambers.government.country` (object) - `response.results.election_events.chambers.government.country.status` (string) The parent organization (e.g., “UN Member State”) or state on which the given Country is dependent (e.g., “Oversea Department of France”). - `response.results.election_events.chambers.government.country.name_short` (string) Short, common name for the country in English. - `response.results.election_events.chambers.government.country.gmi_3` (string) Three-letter Global Mapping International (GMI) country/territory code for the country. - `response.results.election_events.chambers.government.country.name_short_iso` (string) Short name (in English) for the country specified in the ISO-3166 standard. - `response.results.election_events.chambers.government.country.name_short_local` (string) Short, common name for the country in the local language. - `response.results.election_events.chambers.government.country.id` (number) The Cicero database ID for the country. Changes after each edit; for a persistent ID, see sk. - `response.results.election_events.chambers.government.country.sk` (number) The surrogate key for the country. - `response.results.election_events.chambers.government.country.name_short_un` (string) United Nations short name for the country. - `response.results.election_events.chambers.government.country.fips` (string) Two-letter U.S. Federal Information Processing Standard No. - `response.results.election_events.chambers.government.country.last_update_date` (string) Date the Cicero research team last made changes to the country's information. - `response.results.election_events.chambers.government.country.iso_3` (string) Three-letter ISO 3166-1 alpha-3 standard code for the country. - `response.results.election_events.chambers.government.country.iso_2` (string) Two-letter ISO 3166-1 alpha-2 standard code for the country. - `response.results.election_events.chambers.government.country.iso_3_numeric` (number,null) Three-digit ISO 3166-1 numeric standard code for the country. - `response.results.election_events.chambers.government.country.name_long_local` (string) Long name for the country in the local language. - `response.results.election_events.chambers.government.country.name_long` (string) Long name for the country in English. - `response.results.election_events.chambers.government.country.valid_from` (string) Deprecated. - `response.results.election_events.chambers.government.country.valid_to` (string,null) Deprecated. - `response.results.election_events.chambers.government.country.version` (number) Deprecated. - `response.results.election_events.chambers.government.notes` (string) Deprecated. - `response.results.election_events.chambers.redistricting_rules` (string) The process of redistricting for the chamber. - `response.results.election_events.chambers.vacancy_rules` (string) The process of how vacancies within the chamber are filled. - `response.results.election_events.chambers.contact_email` (string) A general email address for contacting the chamber. - `response.results.election_events.chambers.last_update_date` (string) Date the Cicero research team last made changes to this district's information. - `response.results.election_events.chambers.remarks` (string) Notable quirks or facts related to the chamber. - `response.results.election_events.chambers.name` (string) Informal name of the chamber in English. - `response.results.election_events.chambers.url` (string) URL to the official webpage of the chamber. - `response.results.election_events.chambers.type` (string) Governmental level of the chamber. - `response.results.election_events.chambers.is_appointed` (boolean) Whether officials in this chamber are appointed rather than elected. - `response.results.election_events.chambers.election_rules` (string) A description of when elections take place. - `response.results.election_events.chambers.legislature_update_date` (string,null) Deprecated. - `response.results.election_events.chambers.is_chamber_complete` (boolean) Deprecated. - `response.results.election_events.chambers.notes` (string) Deprecated. - `response.results.election_events.chambers.has_geographic_representation` (boolean) Deprecated. - `response.results.election_events.valid_from` (string) Deprecated. - `response.results.election_events.valid_to` (string,null) Deprecated. - `response.results.count` (object) - `response.results.count.from` (integer) - `response.results.count.to` (integer) - `response.results.count.total` (integer) ## Response 400 fields (application/json): - `response` (object) - `response.errors` (array) If the request encountered an error or errors, details about the error(s) will be contained in this field. Example: ["A detailed message about the error."] - `response.messages` (array) Contains the resources matching the request query, if any. - `response.results` (object) Contains additional information about the outcome of a request that is not an error and not part of a query result.