# Find redistricting events 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 Endpoint: GET /redistricting_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}" - `begin_date_before` (string) 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. Example: "today" - `complete_date_after` (string) 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. Example: "tomorrow" - `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.redistricting_events` (array) - `response.results.redistricting_events.id` (number) The Cicero database ID for the redistricting event. Changes after each edit; for a persistent ID, see sk. - `response.results.redistricting_events.sk` (number) The surrogate key for the redistricting event. - `response.results.redistricting_events.last_update_date` (string) Date the Cicero research team last made changes to the election's information. - `response.results.redistricting_events.label` (string) The name of the redistricting event. - `response.results.redistricting_events.state` (string) The state or country subdivision where the redistricting event occurred. - `response.results.redistricting_events.remarks` (string) Specific details about the election that describe the event. - `response.results.redistricting_events.begin_date` (string,null) The date when the redistricting event started. - `response.results.redistricting_events.begin_date_is_approximate` (boolean) Whether the redistricting event's begin_date is not accurate or precise to the day. - `response.results.redistricting_events.complete_date` (string,null) The date when the redistricting event completed. - `response.results.redistricting_events.complete_date_is_approximate` (boolean) Whether the redistricting event's complete_date is not accurate or precise to the day. - `response.results.redistricting_events.email` (string,null) The email for the redistricting event. - `response.results.redistricting_events.urls` (array) A list of URL strings for pages with more information about the election. - `response.results.redistricting_events.chambers` (array) A list of chamber objects for chambers with modified districts in the redistricting event. - `response.results.redistricting_events.chambers.official_count` (number,null) The number of officials serving in the chamber. - `response.results.redistricting_events.chambers.id` (number,null) The Cicero database ID for the chamber. Changes after each edit; not persistent. - `response.results.redistricting_events.chambers.term_length` (string) The length of time for each term that officials serve in the chamber. - `response.results.redistricting_events.chambers.term_limit` (string) The maximum number of terms officials within the chamber can serve. - `response.results.redistricting_events.chambers.inauguration_rules` (string) The process for inaugurating officials within the chamber. - `response.results.redistricting_events.chambers.name_native_language` (string) Name of the chamber in the government's official language. - `response.results.redistricting_events.chambers.contact_phone` (string) A general phone number for contacting the chamber. - `response.results.redistricting_events.chambers.name_formal` (string) English formal name of the chamber. - `response.results.redistricting_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.redistricting_events.chambers.government` (object) - `response.results.redistricting_events.chambers.government.name` (string) The formal name of the government. - `response.results.redistricting_events.chambers.government.type` (string) A category describing the level of government. - `response.results.redistricting_events.chambers.government.city` (string) The city that the government governs. - `response.results.redistricting_events.chambers.government.state` (string) The state, province, or region that the government governs. - `response.results.redistricting_events.chambers.government.country` (object) - `response.results.redistricting_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.redistricting_events.chambers.government.country.name_short` (string) Short, common name for the country in English. - `response.results.redistricting_events.chambers.government.country.gmi_3` (string) Three-letter Global Mapping International (GMI) country/territory code for the country. - `response.results.redistricting_events.chambers.government.country.name_short_iso` (string) Short name (in English) for the country specified in the ISO-3166 standard. - `response.results.redistricting_events.chambers.government.country.name_short_local` (string) Short, common name for the country in the local language. - `response.results.redistricting_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.redistricting_events.chambers.government.country.sk` (number) The surrogate key for the country. - `response.results.redistricting_events.chambers.government.country.name_short_un` (string) United Nations short name for the country. - `response.results.redistricting_events.chambers.government.country.fips` (string) Two-letter U.S. Federal Information Processing Standard No. - `response.results.redistricting_events.chambers.government.country.last_update_date` (string) Date the Cicero research team last made changes to the country's information. - `response.results.redistricting_events.chambers.government.country.iso_3` (string) Three-letter ISO 3166-1 alpha-3 standard code for the country. - `response.results.redistricting_events.chambers.government.country.iso_2` (string) Two-letter ISO 3166-1 alpha-2 standard code for the country. - `response.results.redistricting_events.chambers.government.country.iso_3_numeric` (number,null) Three-digit ISO 3166-1 numeric standard code for the country. - `response.results.redistricting_events.chambers.government.country.name_long_local` (string) Long name for the country in the local language. - `response.results.redistricting_events.chambers.government.country.name_long` (string) Long name for the country in English. - `response.results.redistricting_events.chambers.government.country.valid_from` (string) Deprecated. - `response.results.redistricting_events.chambers.government.country.valid_to` (string,null) Deprecated. - `response.results.redistricting_events.chambers.government.country.version` (number) Deprecated. - `response.results.redistricting_events.chambers.government.notes` (string) Deprecated. - `response.results.redistricting_events.chambers.redistricting_rules` (string) The process of redistricting for the chamber. - `response.results.redistricting_events.chambers.vacancy_rules` (string) The process of how vacancies within the chamber are filled. - `response.results.redistricting_events.chambers.contact_email` (string) A general email address for contacting the chamber. - `response.results.redistricting_events.chambers.last_update_date` (string) Date the Cicero research team last made changes to this district's information. - `response.results.redistricting_events.chambers.remarks` (string) Notable quirks or facts related to the chamber. - `response.results.redistricting_events.chambers.name` (string) Informal name of the chamber in English. - `response.results.redistricting_events.chambers.url` (string) URL to the official webpage of the chamber. - `response.results.redistricting_events.chambers.type` (string) Governmental level of the chamber. - `response.results.redistricting_events.chambers.is_appointed` (boolean) Whether officials in this chamber are appointed rather than elected. - `response.results.redistricting_events.chambers.election_rules` (string) A description of when elections take place. - `response.results.redistricting_events.chambers.legislature_update_date` (string,null) Deprecated. - `response.results.redistricting_events.chambers.is_chamber_complete` (boolean) Deprecated. - `response.results.redistricting_events.chambers.notes` (string) Deprecated. - `response.results.redistricting_events.chambers.has_geographic_representation` (boolean) Deprecated. - `response.results.redistricting_events.valid_from` (string) Deprecated. - `response.results.redistricting_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.