---
title: "Find election events"
method: GET
path: "/election_event"
tags: ["Events"]
---

# Find election events

`GET /election_event`

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

## Query parameters

- `format` 'json' | 'xml'
- `customer_id` string, password, required
- `key` string, password
- `election_expire_date_on_or_after` string
- `election_expire_date_before` string
- `max` integer
- `offset` integer

## Headers

- `Accept` 'application/json' | '*/*', required
- `Content-Type` 'application/json' | 'application/xml', required

## Response `200`

Successful response

- object
  - `response` ResponseElectionEvent
    - `errors` unknown[] — If the request encountered an error or errors, details about the error(s) will be contained in this field.
      - unknown
    - `messages` unknown[] — Contains the resources matching the request query, if any.
      - unknown
    - `results` object — Contains additional information about the outcome of a request that is not an error and not part of a query result.
      - `election_events` ElectionEventObject[]
        - `id` number — The Cicero database ID for the election event. Changes after each edit; for a persistent ID, see `sk`.
        - `sk` number — The surrogate key for the election event.
        - `valid_from` string — Deprecated.
        - `valid_to` string — Deprecated.
        - `last_update_date` string — Date the Cicero research team last made changes to the election's information.
        - `label` string — The name of the election.
        - `remarks` string — Specific details about the election that describe the event.
        - `election_date_text` string — A description of the date or dates that an election is being held.
        - `election_expire_date` string — The date when voting in the election completes. Some elections span several days; this will be the last day.
        - `is_approximate` boolean — Whether the election event's election_expire_date is not accurate or precise to the day.
        - `is_by_election` boolean — Whether the election is a special election that falls outside the regular calendar.
        - `is_primary_election` boolean — Whether the election is a primary election that precedes the general election.
        - `is_runoff_election` boolean — Whether the election is a second, third, or later election used for deciding between the top candidates in earlier elections.
        - `is_referendum` boolean — Whether the election event is specifically about a referendum on the ballot.
        - `is_local` boolean — Whether the election is for an office of local government (e.g., a municipal, county, or town election).
        - `is_state` boolean — Whether the election is for an office of regional government (e.g., sub-national state, provincial, or prefecture election).
        - `is_national` boolean — Whether the election is for an office of the nation state.
        - `is_transnational` boolean — Whether the election is for an office of a trans-national institution.
        - `urls` string[] — A list of URL strings for pages with more information about the election.
        - `chambers` ChamberObject[] — A list of chamber objects for chambers with members up for election.
          - `legislature_update_date` string — Deprecated.
          - `official_count` number — The number of officials serving in the chamber.
          - `id` number — The Cicero database ID for the chamber. Changes after each edit; not persistent.
          - `term_length` string — The length of time for each term that officials serve in the chamber.
          - `term_limit` string — The maximum number of terms officials within the chamber can serve.
          - `inauguration_rules` string — The process for inaugurating officials within the chamber.
          - `name_native_language` string — Name of the chamber in the government's official language.
          - `contact_phone` string — A general phone number for contacting the chamber.
          - `name_formal` string — English formal name of the chamber.
          - `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.
          - `government` GovernmentObject
            - `name` string — The formal name of the government.
            - `type` string — A category describing the level of government.
            - `city` string — The city that the government governs.
            - `state` string — The state, province, or region that the government governs.
            - `country` CountryObject
              - …
            - `notes` string — Deprecated.
          - `redistricting_rules` string — The process of redistricting for the chamber.
          - `vacancy_rules` string — The process of how vacancies within the chamber are filled.
          - `is_chamber_complete` boolean — Deprecated.
          - `contact_email` string — A general email address for contacting the chamber.
          - `last_update_date` string — Date the Cicero research team last made changes to this district's information.
          - `remarks` string — Notable quirks or facts related to the chamber.
          - `name` string — Informal name of the chamber in English.
          - `url` string — URL to the official webpage of the chamber.
          - `type` string — Governmental level of the chamber.
          - `notes` string — Deprecated.
          - `has_geographic_representation` boolean — Deprecated.
          - `is_appointed` boolean — Whether officials in this chamber are appointed rather than elected.
          - `election_rules` string — A description of when elections take place.
      - `count` CountObject
        - `from` integer
        - `to` integer
        - `total` integer

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/melissa/apis/cicero.md) · [All operations](https://skmtc.net/melissa/apis/cicero/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melissa/cicero/versions/34d86f140b3f/schema)