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

# GET /v1/elections/search/

`GET /v1/elections/search/`

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

List elections by cycle, office, state, and district.

## Query parameters

- `page` integer
- `per_page` integer
- `state` string[]
- `district` string[]
- `cycle` integer[]
- `zip` integer[]
- `office` string[]
- `sort` string[]
- `sort_hide_null` boolean
- `sort_null_only` boolean
- `sort_nulls_last` boolean
- `api_key` string

## Response `default`

Default response

- ElectionsListPage
  - `pagination` OffsetInfo
    - `count` integer
    - `is_count_exact` boolean
    - `page` integer
    - `pages` integer
    - `per_page` integer
  - `results` ElectionsList[]
    - `cycle` integer, nullable
    - `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.
    - `office` string, nullable: Federal office candidate runs for: H, S or P
    - `state` string, nullable: US state or territory

---

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