---
title: "GET /v1/election-dates/"
method: GET
path: "/v1/election-dates/"
tags: ["dates"]
---

# GET /v1/election-dates/

`GET /v1/election-dates/`

## Request

- Base URL: `https://api.open.fec.gov` (the document declares no server; this is the origin it was published from)
- URL: `https://api.open.fec.gov/v1/election-dates/`
- Auth: API key in header `X-Api-Key` and API key in query parameter `api_key` and API key in query parameter `api_key`
- TypeScript: <https://skmtc.dev/fec/apis/openfec/docs/v1/election-dates/get.ts> (a function with typed inputs; its response is checked against the schema)

FEC election dates since 1995.

## Query parameters

- `page` integer
- `per_page` integer
- `election_state` string[]
- `election_district` string[]
- `election_party` string[]
- `office_sought` string[]
- `min_election_date` string
- `max_election_date` string
- `election_type_id` string[]
- `min_create_date` string
- `max_create_date` string
- `min_update_date` string
- `max_update_date` string
- `election_year` string[]
- `min_primary_general_date` string
- `max_primary_general_date` string
- `sort` string
- `sort_hide_null` boolean
- `sort_null_only` boolean
- `sort_nulls_last` boolean
- `api_key` string

## Response `default`

Default response

- ElectionDatesPage
  - `pagination` OffsetInfo
    - `count` integer
    - `is_count_exact` boolean
    - `page` integer
    - `pages` integer
    - `per_page` integer
  - `results` ElectionDates[]
    - `active_election` boolean
    - `create_date` string, date-time, nullable: Date the record was created
    - `election_date` string, date, nullable: Date of election
    - `election_district` string, nullable: Two-digit US House distirict of the office the candidate is running for. Presidential, Senate and House at-large candidates will have District 00.
    - `election_notes` string, nullable
    - `election_party` string, nullable: Three-letter code for the party affiliated with a candidate or committee. For example, DEM for Democratic Party and REP for Republican Party.
    - `election_state` string, nullable: US state or territory where a candidate runs for office
    - `election_type_full` string
    - `election_type_id` string, nullable: Election type Convention, Primary, General, Special, Runoff etc.
    - `election_year` integer, nullable: Year of election
    - `office_sought` string, nullable: Federal office candidate runs for: H, S or P
    - `primary_general_date` string, date, nullable
    - `update_date` string, date-time, nullable: Date the record was updated

---

[API](https://skmtc.dev/fec/apis/openfec.md) - [All operations](https://skmtc.dev/fec/apis/openfec/llms.txt) - [OpenAPI document](https://skmtc.dev/fec/apis/openfec/revisions/d2eb3171e225?raw)