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

# GET /v1/efile/filings/

`GET /v1/efile/filings/`

## 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/filings/`
- 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/filings/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[]
- `min_receipt_date` string
- `max_receipt_date` string
- `q_filer` string[]
- `form_type` string[]
- `sort` string
- `sort_hide_null` boolean
- `sort_null_only` boolean
- `sort_nulls_last` boolean
- `api_key` string

## Response `default`

Default response

- EFilingsPage
  - `pagination` OffsetInfo
    - `count` integer
    - `is_count_exact` boolean
    - `page` integer
    - `pages` integer
    - `per_page` integer
  - `results` EFilings[]
    - `amended_by` integer
    - `amendment_chain` integer[]
    - `amendment_number` integer, nullable: Number of times the report has been amended.
    - `amends_file` integer, nullable: For amendments, this file_number is the file_number of the previous report that is being amended. Refer to the amended_by for the most recent version of the report.
    - `beginning_image_number` string
    - `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.
    - `coverage_end_date` string, date, nullable: Ending date of the reporting period
    - `coverage_start_date` string, date, nullable: Beginning date of the reporting period
    - `csv_url` string
    - `document_description` string
    - `ending_image_number` string
    - `fec_file_id` string
    - `fec_url` string
    - `file_number` integer: Filing ID number
    - `filed_date` string, date, nullable: Timestamp of electronic or paper record that FEC received
    - `form_type` string, nullable: The form where the underlying data comes from, for example Form 1 would appear as F1: - F1 Statement of Organization - F1M Notification of Multicandidate Status - F2 Statement of Candidacy - F24 24/48 Hour Report of Independent Expenditures - F3 Report of Receipts and Disbursements for an Authorized Committee - F3P Report of Receipts and Disbursements by an Authorized Committee of a Candidate for The Office of President or Vice President - F3L Report of Contributions Bundled by Lobbyists/Registrants and Lobbyist/Registrant PACs - F3X Report of Receipts and Disbursements for other than an Authorized Committee - F4 Report of Receipts and Disbursements for a Committee or Organization Supporting a Nomination Convention - F5 Report of Independent Expenditures Made and Contributions Received - F6 48 Hour Notice of Contributions/Loans Received - F7 Report of Communication Costs by Corporations and Membership Organizations - F8 Debt Settlement Plan - F9 24 Hour Notice of Disbursements for Electioneering Communications - F13 Report of Donations Accepted for Inaugural Committee - F99 Miscellaneous Text NOTE: This filter also works if you specify new, amended, or termination, for example F3XN, F3XA, or F3XT respectively
    - `html_url` string
    - `is_amended` boolean
    - `load_timestamp` string, date-time, nullable: Date the information was loaded into the FEC systems. This can be affected by reseting systems and other factors, refer to receipt_date for the day that the FEC received the paper or electronic document. Keep in mind that paper filings take more time to process and there can be a lag between load_date and receipt_date. This field can be helpful to identify paper records that have been processed recently.
    - `most_recent` boolean
    - `most_recent_filing` integer
    - `pdf_url` string
    - `receipt_date` string, date-time, nullable: Date the FEC received the electronic or paper record

---

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