--- title: "GET /v1/efile/form1/" method: GET path: "/v1/efile/form1/" tags: ["efiling"] --- # GET /v1/efile/form1/ `GET /v1/efile/form1/` ## 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/form1/` - 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: (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` string[] - `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 - `committee_type` string[] - `organization_type` string[] - `sort` string - `sort_hide_null` boolean - `sort_null_only` boolean - `sort_nulls_last` boolean - `api_key` string ## Response `default` Default response - Form1Page - `pagination` OffsetInfo - `count` integer - `is_count_exact` boolean - `page` integer - `pages` integer - `per_page` integer - `results` Form1[] - `affiliated_candidate_id` string, nullable - `affiliated_committee_city` string, nullable - `affiliated_committee_id` string, nullable - `affiliated_committee_name` string, nullable: Affiliated committee or connected organization - `affiliated_committee_state` string, nullable - `affiliated_committee_str1` string, nullable - `affiliated_committee_str2` string, nullable - `affiliated_committee_zip` string, nullable - `affiliated_relationship_code` string, nullable - `candidate_district` string, nullable: House district of the office sought, if applicable. - `candidate_first_name` string, nullable: First name of candidate running for office - `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 last name - `candidate_middle_name` string, nullable: Middle name of candidate running for office - `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. - `city` string, nullable - `committee_city` string, nullable: City of committee as reported on the Form 1 - `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: The name of the committee. If a committee changes its name, the most recent name will be shown. Committee names are not unique. Use committee_id for looking up records. - `committee_state` string, nullable: State of the committee's address as filed on the Form 1 - `committee_str1` string, nullable: Street address of committee as reported on the Form 1 - `committee_str2` string, nullable: Second line of street address of committee as reported on the Form 1 - `committee_type` string, nullable: Box checked on Form 1 Line 5 - A principal campaign committee - B other authorized committee - C single candidate independent expenditure-only committee - D party committee - E PAC - seperate segregated fund - F PAC - nonconnected - G independent expenditure-only (super PACs) - H PAC with non-contribution account (hybrid PACs) - I joint fundraising representative (at least one authorized) - J joint fundraising representative (no authorized committees) - `committee_zip` string, nullable: Zip code of committee as reported on the Form 1 - `derived_committee_type` string, nullable: Additional Form 1 and 1s Line 5 information The rules for assigning a derived committee type use data from real_efile.f1 and real_efile.f1s to determine that committee type. Except for joint fundraising representative committees (JFR), derived committee type is determined by committee_type or a combination of committee_type and candidate_office from from the F1 row. Derived committee type for JFRs is determined using one additional column from F1S, joint fundraising committee type (jfr_cmte_type), and the reference rule in the electronic filing specifications. - H house - N political action committee (PAC) - O independent expenditure-only (super PACs) - P presidential - S senate - U single candidate independent expenditure-only committee - V PAC with non-contribution account (hybrid PACs) - X party - `election_state` string, nullable: State or territory of the office sought. - `email` string, nullable: Email as reported on the Form 1 - `file_number` integer: Filing ID number - `image_number` string - `load_timestamp` string - `organization_type` string, nullable: The one-letter code for the kind for organization: - C corporation - L labor organization - M membership organization - T trade association - V cooperative - W corporation without capital stock - H host committee - I inaugural committee - `pdf_url` string - `state` string, nullable: US state or territory where a candidate runs for office - `street_1` string, nullable - `street_2` string, nullable - `treasurer_city` string, nullable: City of committee treasurer as reported on the Form 1 - `treasurer_first_name` string, nullable: Name 1 of committee treasurer as reported on the Form 1 - `treasurer_last_name` string, nullable - `treasurer_middle_name` string, nullable: Middle name of committee treasurer as reported on the Form 1 - `treasurer_state` string, nullable: State of committee treasurer as reported on the Form 1 - `treasurer_str1` string, nullable: Street of committee treasurer as reported on the Form 1 - `treasurer_str2` string, nullable: Second line of the street of committee treasurer as reported on the Form 1 - `treasurer_zip` string, nullable: Zip code of committee treasurer as reported on the Form 1 - `zip` string, nullable: Zip code --- [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)