---
title: "GET /v1/efile/form2/"
method: GET
path: "/v1/efile/form2/"
tags: ["efiling"]
---

# GET /v1/efile/form2/

`GET /v1/efile/form2/`

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

Basic information about electronic files coming into the FEC, posted as they are received.

## Query parameters

- `page` integer
- `per_page` integer
- `file_number` integer[]
- `committee_id` string[]
- `candidate_id` string[]
- `election_state` string[]
- `candidate_office` string[]
- `candidate_district` string[]
- `candidate_party` string[]
- `image_number` string[]
- `min_load_timestamp` string
- `max_load_timestamp` string
- `sort` string
- `sort_hide_null` boolean
- `sort_null_only` boolean
- `sort_nulls_last` boolean
- `api_key` string

## Response `default`

Default response

- Form2Page
  - `pagination` OffsetInfo
    - `count` integer
    - `is_count_exact` boolean
    - `page` integer
    - `pages` integer
    - `per_page` integer
  - `results` Form2[]
    - `address_city` string, nullable
    - `address_state` string, nullable
    - `address_str1` string, nullable
    - `address_str2` string, nullable
    - `address_zip` string, nullable
    - `candidate_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.
    - `candidate_first_name` string, nullable
    - `candidate_id` string, nullable: A unique identifier assigned to each candidate registered with the FEC. If a person runs for several offices, that person will have separate candidate IDs for each office. First character indicates office - [P]residential, [H]ouse, [S]enate]. Second character is the last digit of the two-year period the ID was created. Third and fourth is the candidate state. Presidential IDs don't have state. Fifth and sixth is the district when the candidate first ran. This does not change if the candidate/member's district changes during re-districting. Presidential IDs don't have districts. The rest is sequence.
    - `candidate_last_name` string, nullable
    - `candidate_middle_name` string, nullable
    - `candidate_name` string
    - `candidate_office` string, nullable: Federal office candidate runs for: H, S or P
    - `candidate_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.
    - `committee_address_city` string, nullable
    - `committee_address_str1` string, nullable
    - `committee_address_str2` string, nullable
    - `committee_address_zip` string, nullable
    - `committee_id` string, nullable: A unique identifier assigned to each committee or filer registered with the FEC. In general a committee id begins with the letter C which is followed by eight digits.
    - `committee_name` string, nullable
    - `election_state` string, nullable: State or territory of the office sought.
    - `election_year` string, nullable
    - `file_number` integer: Filing ID number
    - `image_number` string
    - `load_timestamp` string
    - `pdf_url` string

---

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