---
title: "GET /v1/elections/"
method: GET
path: "/v1/elections/"
tags: ["financial"]
---

# GET /v1/elections/

`GET /v1/elections/`

## 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/elections/`
- 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/elections/get.ts> (a function with typed inputs; its response is checked against the schema)

Look at the top-level financial information for all candidates running for the same
office.

Choose a 2-year cycle, and `house`, `senate` or `presidential`.

If you are looking for a Senate seat, you will need to select the state using a two-letter
abbreviation.

House races require state and a two-digit district number.

Since this endpoint reflects financial information, it will only have candidates once they file
financial reporting forms. Query the `/candidates` endpoint to retrieve an-up-to-date list of all the
candidates that filed to run for a particular seat.

## Query parameters

- `page` integer
- `per_page` integer
- `state` string
- `district` string
- `cycle` integer, required
- `office` 'house' | 'senate' | 'president', required
- `election_full` boolean
- `sort` string
- `sort_hide_null` boolean
- `sort_null_only` boolean
- `sort_nulls_last` boolean
- `api_key` string

## Response `default`

Default response

- ElectionPage
  - `pagination` OffsetInfo
    - `count` integer
    - `is_count_exact` boolean
    - `page` integer
    - `pages` integer
    - `per_page` integer
  - `results` Election[]
    - `candidate_election_year` integer
    - `candidate_id` string
    - `candidate_name` string
    - `candidate_pcc_id` string: The candidate's primary campaign committee ID
    - `candidate_pcc_name` string: The candidate's primary campaign committee name
    - `cash_on_hand_end_period` number
    - `committee_ids` string[]
    - `coverage_end_date` string, date
    - `incumbent_challenge_full` string
    - `party_full` string
    - `total_disbursements` number
    - `total_receipts` number

---

[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)