---
type: "firecrawl-provider"
description: "US Federal Election Commission campaign finance data from the openFEC API: federal candidates and committees, committee financial totals per cycle, filed reports, itemized disbursements (Schedule B), independent expenditures (Schedule E) and individual-contribution aggregates by size, state and employer. Committee, candidate and aggregate data only: itemized individual contributions (Schedule A rows with contributor names) are not exposed, and Schedule B contribution refunds to individuals are withheld, because 52 U.S.C. 30111(a)(4) bars using individual contributor information for soliciting contributions or commercial purposes."
use_when: "US Federal Election Commission campaign finance data from the openFEC API: federal candidates and committees, committee financial totals per cycle, filed reports, itemized disbursements (Schedule B), independent expenditures (Schedule E) and individual-contribution aggregates by size, state and employer. Committee, candidate and aggregate data only: itemized individual contributions (Schedule A rows with contributor names) are not exposed, and Schedule B contribution refunds to individuals are withheld, because 52 U.S.C. 30111(a)(4) bars using individual contributor information for soliciting contributions or commercial purposes."
categories: "Public records"
capabilities: 7
credits_per_call: 5
---
# FEC on Firecrawl Alexandria

US Federal Election Commission campaign finance data from the openFEC API: federal candidates and committees, committee financial totals per cycle, filed reports, itemized disbursements (Schedule B), independent expenditures (Schedule E) and individual-contribution aggregates by size, state and employer. Committee, candidate and aggregate data only: itemized individual contributions (Schedule A rows with contributor names) are not exposed, and Schedule B contribution refunds to individuals are withheld, because 52 U.S.C. 30111(a)(4) bars using individual contributor information for soliciting contributions or commercial purposes.

- Categories: Public records
- Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records)
- Provider key: `fec-gov`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/fec-gov)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/fec-gov/openapi.json)

## Capabilities

- [Candidates](https://firecrawl.dev/alexandria/agents/providers/fec-gov/records/candidates): Search FEC candidates for federal office (House, Senate, President) by name, ID, office, state, party, district or election year. Each row is one FEC candidate ID with party, incumbency, status, the cycles it is active in and its principal campaign committees.
- [Committee totals](https://firecrawl.dev/alexandria/agents/providers/fec-gov/records/committee_totals): Financial totals for one FEC committee per two-year cycle, summed from its F3, F3P or F3X reports: receipts, contributions (individual itemized and unitemized, PAC, party, candidate), loans, transfers, disbursements, operating expenditures, independent expenditures, cash on hand and debts, with the coverage dates of the latest report. Newest cycle first.
- [Committees](https://firecrawl.dev/alexandria/agents/providers/fec-gov/records/committees): Search FEC-registered committees: candidate campaign committees, PACs, super PACs, hybrid PACs and party committees. Filter by name, committee ID, linked candidate, committee type, designation, state, party or cycle. Rows carry type, designation, treasurer, linked candidate IDs and active cycles.
- [Disbursements](https://firecrawl.dev/alexandria/agents/providers/fec-gov/records/disbursements): Itemized disbursements (FEC Schedule B): who a committee paid, how much, when and for what (purpose, category, report line), newest first or by amount. Filter by spending committee, recipient name or committee, recipient state, purpose category, transaction period, date and amount ranges. Contribution refunds to individuals (lines 20a/28a) are withheld because they name individual contributors.
- [Filings](https://firecrawl.dev/alexandria/agents/providers/fec-gov/records/filings): Reports and statements filed with the FEC (F3/F3P/F3X financial reports, F24/F5 independent-expenditure reports, F1/F2 registrations and others), newest receipt first. Filter by committee, candidate, filer name, form, report type, report year, cycle, receipt date range or most-recent version. Rows include coverage dates, summary totals, amendment state and links to the filed PDF, HTML, .fec and CSV.
- [Independent expenditures](https://firecrawl.dev/alexandria/agents/providers/fec-gov/records/independent_expenditures): Independent expenditures (FEC Schedule E): spending by super PACs, PACs, parties and others expressly for or against a federal candidate, with spender, candidate, support or oppose, amount, expenditure and dissemination dates, payee and purpose. Filter by spender, candidate, support/oppose, cycle, candidate office/state/party, payee, date and amount ranges; newest first or by amount.
- [Receipt aggregates](https://firecrawl.dev/alexandria/agents/providers/fec-gov/records/receipt_aggregates): Aggregated individual contributions to one committee for a cycle, by contribution size (five buckets; the $200-and-under bucket includes unitemized money), by contributor state, or by contributor employer: total dollars and contribution count per bucket. Aggregates only; no contributor names.

## 1. Choose this provider when

US Federal Election Commission campaign finance data from the openFEC API: federal candidates and committees, committee financial totals per cycle, filed reports, itemized disbursements (Schedule B), independent expenditures (Schedule E) and individual-contribution aggregates by size, state and employer. Committee, candidate and aggregate data only: itemized individual contributions (Schedule A rows with contributor names) are not exposed, and Schedule B contribution refunds to individuals are withheld, because 52 U.S.C. 30111(a)(4) bars using individual contributor information for soliciting contributions or commercial purposes.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "fec-gov",
  "capability": "records/candidates",
  "options": {
    "candidate_id": "S2MA00170"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `api_key` (string): api.data.gov key for the FEC API, normally supplied by the calling platform. Sent only as the X-Api-Key header; never placed in URLs or output. Omitted, the call uses api.data.gov's public DEMO_KEY (10 requests per hour per IP) and returns a demo_key warning. Pattern: ^[A-Za-z0-9]{20,64}$. Example: `<api_key>`
- `candidate_id` (string): FEC candidate ID, e.g. S2MA00170 (H House, S Senate, P President). Pattern: ^[HSPhsp][0-9A-Za-z]{8}$. Example: `<candidate_id>`
- `cycle` (number): Cycle in which the candidate was active, named by its even year: 2024 covers 2023-2024. Example: `1976`
- `district` (string): House district, two digits (00 at-large). Pattern: ^[0-9]{2}$. Example: `<district>`
- `election_year` (number): Year of an election the candidate ran in. Example: `1976`
- `has_raised_funds` (boolean): Only candidates whose committees reported receipts. Example: `false`
- `is_active_candidate` (boolean): is_active_candidate Example: `false`
- `office` (string): H House, S Senate, P President. Example: `H`
- `page` (number): 1-based page; pass the previous next_page with the same filters. Example: `1`
- `party` (string): Three-letter FEC party code, e.g. DEM, REP, LIB, GRE, IND. Pattern: ^[A-Za-z0-9]{3}$. Example: `<party>`
- `per_page` (number): Rows per page, 1 to 100. Example: `10`
- `query` (string): Name search, e.g. warren. Pattern: \S. Example: `<query>`
- `state` (string): Two-letter US state or territory code, e.g. MA. Pattern: ^[A-Za-z]{2}$. Example: `<state>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "fec-gov",
    capability: "records/candidates",
    options: {
      candidate_id: "S2MA00170",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "fec-gov",
  "capability": "records/candidates",
  "options": {
    "candidate_id": "S2MA00170"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "fec-gov",
    "capability": "records/candidates",
    "options": {
      "candidate_id": "S2MA00170"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'fec-gov/records/candidates' \
  --options '{"candidate_id":"S2MA00170"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "fec-gov",
  "capability": "records/candidates",
  "options": {
    "candidate_id": "S2MA00170"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "fec-gov",
  "capability": "records/candidates",
  "options": {
    "candidate_id": "S2MA00170"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "count_is_exact": true,
  "next_page": null,
  "observed_at_ms": 1791423237000,
  "page": 1,
  "per_page": 10,
  "records": [
    {
      "active_through": 2030,
      "candidate_id": "S2MA00170",
      "candidate_inactive": false,
      "candidate_status": "C",
      "cycles": [
        2012,
        2014,
        2016,
        2018,
        2020,
        2022,
        2024,
        2026
      ],
      "district": "00",
      "district_number": 0,
      "election_districts": [
        "00",
        "00",
        "00",
        "00"
      ],
      "election_years": [
        2012,
        2018,
        2024,
        2030
      ],
      "fec_url": "https://www.fec.gov/data/candidate/S2MA00170/",
      "federal_funds_flag": false,
      "first_file_date": "2011-08-19",
      "has_raised_funds": true,
      "inactive_election_years": null,
      "incumbent_challenge": "I",
      "incumbent_challenge_full": "Incumbent",
      "last_f2_date": "2025-08-26",
      "last_file_date": "2025-08-26",
      "load_date": "2025-08-26T21:03:22",
      "name": "WARREN, ELIZABETH",
      "office": "S",
      "office_full": "Senate",
      "party": "DEM",
      "party_full": "DEMOCRATIC PARTY",
      "principal_committees": [
        {
          "affiliated_committee_name": "MASSACHUSETTS SENATE VICTORY 2024",
          "candidate_ids": [
            "S2MA00170"
          ],
          "committee_id": "C00500843",
          "committee_type": "S",
          "committee_type_full": "Senate",
          "cycles": [
            2012,
            2014,
            2016,
            2018,
            2020,
            2022,
            2024,
            2026
          ],
          "designated_agent_city": null,
          "designated_agent_first_name": null,
          "designated_agent_last_name": null,
          "designated_agent_middle_name": null,
          "designated_agent_name": null,
          "designated_agent_phone_number": null,
          "designated_agent_prefix": null,
          "designated_agent_state": null,
          "designated_agent_street1": null,
          "designated_agent_street2": null,
          "designated_agent_suffix": null,
          "designated_agent_title": null,
          "designated_agent_zip": null,
          "designation": "P",
          "designation_full": "Principal campaign committee",
          "filing_frequency": "Q",
          "first_f1_date": "2011-08-18",
          "first_file_date": "2011-08-18",
          "last_f1_date": "2025-08-26",
          "last_file_date": "2026-07-15",
          "name": "WARREN FOR SENATE, INC.",
          "organization_type": null,
          "organization_type_full": null,
          "party": "DEM",
          "party_full": "DEMOCRATIC PARTY",
          "state": "MA",
          "treasurer_name": "EGERMAN, PAUL"
        }
      ],
      "state": "MA"
    }
  ],
  "source_url": "https://api.open.fec.gov/v1/candidates/search/?candidate_id=S2MA00170&sort=name&page=1&per_page=10",
  "total_count": 1,
  "total_pages": 1
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Candidates

- Capability: `records/candidates`
- Description: Search FEC candidates for federal office (House, Senate, President) by name, ID, office, state, party, district or election year. Each row is one FEC candidate ID with party, incumbency, status, the cycles it is active in and its principal campaign committees.
- Instructions: Find a federal candidate's FEC candidate ID and principal campaign committee before asking for totals, filings or independent expenditures.
- Cost: 5 credits per call
- Capability file: [Candidates](https://firecrawl.dev/alexandria/agents/providers/fec-gov/records/candidates)

Accepted options:
- `api_key` (string): api.data.gov key for the FEC API, normally supplied by the calling platform. Sent only as the X-Api-Key header; never placed in URLs or output. Omitted, the call uses api.data.gov's public DEMO_KEY (10 requests per hour per IP) and returns a demo_key warning. Pattern: ^[A-Za-z0-9]{20,64}$. Example: `<api_key>`
- `candidate_id` (string): FEC candidate ID, e.g. S2MA00170 (H House, S Senate, P President). Pattern: ^[HSPhsp][0-9A-Za-z]{8}$. Example: `<candidate_id>`
- `cycle` (number): Cycle in which the candidate was active, named by its even year: 2024 covers 2023-2024. Example: `1976`
- `district` (string): House district, two digits (00 at-large). Pattern: ^[0-9]{2}$. Example: `<district>`
- `election_year` (number): Year of an election the candidate ran in. Example: `1976`
- `has_raised_funds` (boolean): Only candidates whose committees reported receipts. Example: `false`
- `is_active_candidate` (boolean): is_active_candidate Example: `false`
- `office` (string): H House, S Senate, P President. Example: `H`
- `page` (number): 1-based page; pass the previous next_page with the same filters. Example: `1`
- `party` (string): Three-letter FEC party code, e.g. DEM, REP, LIB, GRE, IND. Pattern: ^[A-Za-z0-9]{3}$. Example: `<party>`
- `per_page` (number): Rows per page, 1 to 100. Example: `10`
- `query` (string): Name search, e.g. warren. Pattern: \S. Example: `<query>`
- `state` (string): Two-letter US state or territory code, e.g. MA. Pattern: ^[A-Za-z]{2}$. Example: `<state>`

Response schema example:
```json
{
  "count_is_exact": true,
  "next_page": null,
  "observed_at_ms": 1791423237000,
  "page": 1,
  "per_page": 10,
  "records": [
    {
      "active_through": 2030,
      "candidate_id": "S2MA00170",
      "candidate_inactive": false,
      "candidate_status": "C",
      "cycles": [
        2012,
        2014,
        2016,
        2018,
        2020,
        2022,
        2024,
        2026
      ],
      "district": "00",
      "district_number": 0,
      "election_districts": [
        "00",
        "00",
        "00",
        "00"
      ],
      "election_years": [
        2012,
        2018,
        2024,
        2030
      ],
      "fec_url": "https://www.fec.gov/data/candidate/S2MA00170/",
      "federal_funds_flag": false,
      "first_file_date": "2011-08-19",
      "has_raised_funds": true,
      "inactive_election_years": null,
      "incumbent_challenge": "I",
      "incumbent_challenge_full": "Incumbent",
      "last_f2_date": "2025-08-26",
      "last_file_date": "2025-08-26",
      "load_date": "2025-08-26T21:03:22",
      "name": "WARREN, ELIZABETH",
      "office": "S",
      "office_full": "Senate",
      "party": "DEM",
      "party_full": "DEMOCRATIC PARTY",
      "principal_committees": [
        {
          "affiliated_committee_name": "MASSACHUSETTS SENATE VICTORY 2024",
          "candidate_ids": [
            "S2MA00170"
          ],
          "committee_id": "C00500843",
          "committee_type": "S",
          "committee_type_full": "Senate",
          "cycles": [
            2012,
            2014,
            2016,
            2018,
            2020,
            2022,
            2024,
            2026
          ],
          "designated_agent_city": null,
          "designated_agent_first_name": null,
          "designated_agent_last_name": null,
          "designated_agent_middle_name": null,
          "designated_agent_name": null,
          "designated_agent_phone_number": null,
          "designated_agent_prefix": null,
          "designated_agent_state": null,
          "designated_agent_street1": null,
          "designated_agent_street2": null,
          "designated_agent_suffix": null,
          "designated_agent_title": null,
          "designated_agent_zip": null,
          "designation": "P",
          "designation_full": "Principal campaign committee",
          "filing_frequency": "Q",
          "first_f1_date": "2011-08-18",
          "first_file_date": "2011-08-18",
          "last_f1_date": "2025-08-26",
          "last_file_date": "2026-07-15",
          "name": "WARREN FOR SENATE, INC.",
          "organization_type": null,
          "organization_type_full": null,
          "party": "DEM",
          "party_full": "DEMOCRATIC PARTY",
          "state": "MA",
          "treasurer_name": "EGERMAN, PAUL"
        }
      ],
      "state": "MA"
    }
  ],
  "source_url": "https://api.open.fec.gov/v1/candidates/search/?candidate_id=S2MA00170&sort=name&page=1&per_page=10",
  "total_count": 1,
  "total_pages": 1
}
```

### Committee totals

- Capability: `records/committee_totals`
- Description: Financial totals for one FEC committee per two-year cycle, summed from its F3, F3P or F3X reports: receipts, contributions (individual itemized and unitemized, PAC, party, candidate), loans, transfers, disbursements, operating expenditures, independent expenditures, cash on hand and debts, with the coverage dates of the latest report. Newest cycle first.
- Instructions: How much a campaign, PAC or party committee raised, spent and has on hand in a cycle. Use the candidate's principal committee ID for a candidate.
- Cost: 5 credits per call
- Capability file: [Committee totals](https://firecrawl.dev/alexandria/agents/providers/fec-gov/records/committee_totals)

Accepted options:
- `api_key` (string): api.data.gov key for the FEC API, normally supplied by the calling platform. Sent only as the X-Api-Key header; never placed in URLs or output. Omitted, the call uses api.data.gov's public DEMO_KEY (10 requests per hour per IP) and returns a demo_key warning. Pattern: ^[A-Za-z0-9]{20,64}$. Example: `<api_key>`
- `committee_id` (string, required): FEC committee ID, e.g. C00500843. Pattern: ^[Cc][0-9]{8}$. Example: `<committee_id>`
- `cycle` (number): Two-year election cycle, named by its even year: 2024 covers 2023-2024. Example: `1976`
- `page` (number): 1-based page; pass the previous next_page with the same filters. Example: `1`
- `per_page` (number): Rows per page, 1 to 100. Example: `10`

Response schema example:
```json
{
  "count_is_exact": true,
  "next_page": null,
  "observed_at_ms": 1791423244000,
  "page": 1,
  "per_page": 10,
  "records": [
    {
      "all_other_loans": 0,
      "candidate_contribution": 0,
      "cash_on_hand_beginning_period": 2324574.82,
      "committee_designation": "P",
      "committee_designation_full": "Principal campaign committee",
      "committee_id": "C00500843",
      "committee_name": "WARREN FOR SENATE, INC.",
      "committee_state": "MA",
      "committee_type": "S",
      "committee_type_full": "Senate",
      "contribution_refunds": 98424.18,
      "contributions": 8755646.64,
      "coverage_end_date": "2024-12-31T00:00:00",
      "coverage_start_date": "2023-01-01T00:00:00",
      "cycle": 2024,
      "disbursements": 7914065.93,
      "filing_frequency": "Q",
      "filing_frequency_full": "Quarterly filer",
      "first_f1_date": "2011-08-18",
      "first_file_date": "2011-08-18",
      "individual_contributions": 8695846.64,
      "individual_itemized_contributions": 4100299.53,
      "individual_unitemized_contributions": 4595547.11,
      "last_beginning_image_number": "202501319748808717",
      "last_cash_on_hand_end_period": 3450046.67,
      "last_debts_owed_by_committee": 0,
      "last_debts_owed_to_committee": 0,
      "last_report_type_full": "YEAR-END",
      "last_report_year": 2024,
      "loan_repayments": 0,
      "loan_repayments_candidate_loans": 0,
      "loan_repayments_other_loans": 0,
      "loans": 0,
      "loans_made_by_candidate": 0,
      "net_contributions": 8657222.46,
      "net_operating_expenditures": 5955611.7,
      "offsets_to_operating_expenditures": 3583.29,
      "operating_expenditures": 5959194.99,
      "organization_type": null,
      "organization_type_full": null,
      "other_disbursements": 1856446.76,
      "other_political_committee_contributions": 59800,
      "other_receipts": 81341.1,
      "party_full": "DEMOCRATIC PARTY",
      "political_party_committee_contributions": 0,
      "receipts": 9039537.78,
      "refunded_individual_contributions": 98024.18,
      "refunded_other_political_committee_contributions": 400,
      "refunded_political_party_committee_contributions": 0,
      "transaction_coverage_date": "2024-12-31",
      "transfers_from_other_authorized_committee": 198966.75,
      "transfers_to_other_authorized_committee": 0,
      "treasurer_name": "EGERMAN, PAUL"
    }
  ],
  "source_url": "https://api.open.fec.gov/v1/committee/C00500843/totals/?cycle=2024&sort=-cycle&page=1&per_page=10",
  "total_count": 1,
  "total_pages": 1
}
```

### Committees

- Capability: `records/committees`
- Description: Search FEC-registered committees: candidate campaign committees, PACs, super PACs, hybrid PACs and party committees. Filter by name, committee ID, linked candidate, committee type, designation, state, party or cycle. Rows carry type, designation, treasurer, linked candidate IDs and active cycles.
- Instructions: Resolve a campaign, PAC or party committee to its FEC committee ID, or list the committees linked to a candidate.
- Cost: 5 credits per call
- Capability file: [Committees](https://firecrawl.dev/alexandria/agents/providers/fec-gov/records/committees)

Accepted options:
- `api_key` (string): api.data.gov key for the FEC API, normally supplied by the calling platform. Sent only as the X-Api-Key header; never placed in URLs or output. Omitted, the call uses api.data.gov's public DEMO_KEY (10 requests per hour per IP) and returns a demo_key warning. Pattern: ^[A-Za-z0-9]{20,64}$. Example: `<api_key>`
- `candidate_id` (string): FEC candidate ID, e.g. S2MA00170 (H House, S Senate, P President). Pattern: ^[HSPhsp][0-9A-Za-z]{8}$. Example: `<candidate_id>`
- `committee_id` (string): FEC committee ID, e.g. C00500843. Pattern: ^[Cc][0-9]{8}$. Example: `<committee_id>`
- `committee_type` (string): P presidential, H House, S Senate, N PAC (nonqualified), Q PAC (qualified), O super PAC, V/W hybrid PAC, X/Y party, Z national party nonfederal, I independent expenditor, C communication cost, D delegate, E electioneering, U single-candidate IE. Example: `C`
- `cycle` (number): Cycle in which the committee was active, named by its even year: 2024 covers 2023-2024. Example: `1976`
- `designation` (string): A authorized by a candidate, P principal campaign committee, J joint fundraiser, U unauthorized, B lobbyist/registrant PAC, D leadership PAC. Example: `A`
- `page` (number): 1-based page; pass the previous next_page with the same filters. Example: `1`
- `party` (string): Three-letter FEC party code, e.g. DEM, REP, LIB, GRE, IND. Pattern: ^[A-Za-z0-9]{3}$. Example: `<party>`
- `per_page` (number): Rows per page, 1 to 100. Example: `10`
- `query` (string): Name search, e.g. actblue. Pattern: \S. Example: `<query>`
- `state` (string): Two-letter US state or territory code, e.g. MA. Pattern: ^[A-Za-z]{2}$. Example: `<state>`

Response schema example:
```json
{
  "count_is_exact": true,
  "next_page": null,
  "observed_at_ms": 1791423252000,
  "page": 1,
  "per_page": 10,
  "records": [
    {
      "affiliated_committee_name": "MASSACHUSETTS SENATE VICTORY 2024",
      "candidate_ids": [
        "S2MA00170"
      ],
      "committee_id": "C00500843",
      "committee_type": "S",
      "committee_type_full": "Senate",
      "cycles": [
        2012,
        2014,
        2016,
        2018,
        2020,
        2022,
        2024,
        2026
      ],
      "designated_agent_city": null,
      "designated_agent_first_name": null,
      "designated_agent_last_name": null,
      "designated_agent_middle_name": null,
      "designated_agent_name": null,
      "designated_agent_phone_number": null,
      "designated_agent_prefix": null,
      "designated_agent_state": null,
      "designated_agent_street1": null,
      "designated_agent_street2": null,
      "designated_agent_suffix": null,
      "designated_agent_title": null,
      "designated_agent_zip": null,
      "designation": "P",
      "designation_full": "Principal campaign committee",
      "fec_url": "https://www.fec.gov/data/committee/C00500843/",
      "filing_frequency": "Q",
      "first_f1_date": "2011-08-18",
      "first_file_date": "2011-08-18",
      "last_f1_date": "2025-08-26",
      "last_file_date": "2026-07-15",
      "name": "WARREN FOR SENATE, INC.",
      "organization_type": null,
      "organization_type_full": null,
      "party": "DEM",
      "party_full": "DEMOCRATIC PARTY",
      "sponsor_candidate_ids": null,
      "sponsor_candidate_list": [],
      "state": "MA",
      "treasurer_name": "EGERMAN, PAUL"
    }
  ],
  "source_url": "https://api.open.fec.gov/v1/committees/?committee_id=C00500843&sort=name&page=1&per_page=10",
  "total_count": 1,
  "total_pages": 1
}
```

### Disbursements

- Capability: `records/disbursements`
- Description: Itemized disbursements (FEC Schedule B): who a committee paid, how much, when and for what (purpose, category, report line), newest first or by amount. Filter by spending committee, recipient name or committee, recipient state, purpose category, transaction period, date and amount ranges. Contribution refunds to individuals (lines 20a/28a) are withheld because they name individual contributors.
- Instructions: See what a campaign, PAC or party committee spent money on, or which committees paid a vendor or another committee.
- Cost: 5 credits per call
- Capability file: [Disbursements](https://firecrawl.dev/alexandria/agents/providers/fec-gov/records/disbursements)

Accepted options:
- `api_key` (string): api.data.gov key for the FEC API, normally supplied by the calling platform. Sent only as the X-Api-Key header; never placed in URLs or output. Omitted, the call uses api.data.gov's public DEMO_KEY (10 requests per hour per IP) and returns a demo_key warning. Pattern: ^[A-Za-z0-9]{20,64}$. Example: `<api_key>`
- `committee_id` (string): Spending committee, e.g. C00500843. Pattern: ^[Cc][0-9]{8}$. Example: `<committee_id>`
- `cursor` (string): next_cursor from the previous call. Keep the same filters and sort. Pattern: ^last_index=[A-Za-z0-9.:_-]{1,40}(&[a-z_]+=[A-Za-z0-9.:_-]{1,40}){0,5}$|^[a-z_]+=[A-Za-z0-9.:_-]{1,40}(&[a-z_]+=[A-Za-z0-9.:_-]{1,40}){1,5}$. Example: `<cursor>`
- `max_amount` (number): Maximum amount in dollars. Example: `10`
- `max_date` (string): Latest disbursement date, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<max_date>`
- `min_amount` (number): Minimum amount in dollars. Example: `10`
- `min_date` (string): Earliest disbursement date, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<min_date>`
- `per_page` (number): Rows per page, 1 to 100. Example: `10`
- `purpose_category` (string): FEC disbursement purpose category. Example: `ADMINISTRATIVE`
- `recipient_committee_id` (string): Committee that received the payment. Pattern: ^[Cc][0-9]{8}$. Example: `<recipient_committee_id>`
- `recipient_name` (string): Recipient name search, e.g. a vendor. Pattern: \S. Example: `<recipient_name>`
- `recipient_state` (string): Two-letter US state or territory code, e.g. MA. Pattern: ^[A-Za-z]{2}$. Example: `<recipient_state>`
- `sort` (string): sort Example: `-disbursement_date`
- `two_year_transaction_period` (number): Transaction period; FEC defaults to the current one, named by its even year: 2024 covers 2023-2024. Example: `1976`

Response schema example:
```json
{
  "count_is_exact": true,
  "next_cursor": "last_index=4021120251167890652&last_disbursement_date=2024-12-30",
  "observed_at_ms": 1791423285000,
  "per_page": 3,
  "records": [
    {
      "amendment_indicator": "A",
      "amendment_indicator_desc": "ADD",
      "back_reference_schedule_id": null,
      "back_reference_transaction_id": null,
      "beneficiary_committee_name": null,
      "candidate_first_name": null,
      "candidate_id": null,
      "candidate_last_name": null,
      "candidate_middle_name": null,
      "candidate_name": null,
      "candidate_office": null,
      "candidate_office_description": null,
      "candidate_office_district": null,
      "candidate_office_state": null,
      "candidate_office_state_full": null,
      "candidate_prefix": null,
      "candidate_suffix": null,
      "category_code": null,
      "category_code_full": null,
      "comm_dt": null,
      "committee_id": "C00500843",
      "committee_name": "WARREN FOR SENATE, INC.",
      "conduit_committee_city": null,
      "conduit_committee_name": null,
      "conduit_committee_state": null,
      "conduit_committee_street1": null,
      "conduit_committee_street2": null,
      "conduit_committee_zip": null,
      "disbursement_amount": 1.75,
      "disbursement_date": "2024-12-31",
      "disbursement_description": "POSTAGE",
      "disbursement_purpose_category": "ADMINISTRATIVE",
      "disbursement_type": null,
      "disbursement_type_description": null,
      "election_type": "P2030",
      "election_type_full": null,
      "entity_type": "ORG",
      "entity_type_desc": "ORGANIZATION",
      "fec_election_type_desc": "PRIMARY",
      "fec_election_year": "2030",
      "file_number": 1870484,
      "filing_form": "F3",
      "image_number": "202501319748808910",
      "line_number": "17",
      "line_number_label": "Operating Expenditures",
      "link_id": 4013120251139337000,
      "load_date": "2025-02-12T02:36:23",
      "memo_code": null,
      "memo_code_full": null,
      "memo_text": null,
      "memoed_subtotal": false,
      "national_committee_nonfederal_account": null,
      "original_sub_id": null,
      "payee_employer": null,
      "payee_first_name": null,
      "payee_last_name": null,
      "payee_middle_name": null,
      "payee_occupation": null,
      "payee_prefix": null,
      "payee_suffix": null,
      "pdf_url": "https://docquery.fec.gov/cgi-bin/fecimg/?202501319748808910",
      "recipient_city": "WASHINGTON",
      "recipient_committee_id": null,
      "recipient_name": "USPS.COM",
      "recipient_state": "DC",
      "recipient_zip": "202600004",
      "ref_disp_excess_flg": null,
      "report_type": "YE",
      "report_year": "2024",
      "schedule_type": "SB",
      "schedule_type_full": "ITEMIZED DISBURSEMENTS",
      "semi_annual_bundled_refund": "0.00",
      "spender_committee_designation": "P",
      "spender_committee_org_type": null,
      "spender_committee_type": "S",
      "sub_id": "4021120251167890905",
      "transaction_id": "500132855",
      "two_year_transaction_period": 2024,
      "unused_recipient_committee_id": null
    },
    {
      "amendment_indicator": "A",
      "amendment_indicator_desc": "ADD",
      "back_reference_schedule_id": null,
      "back_reference_transaction_id": null,
      "beneficiary_committee_name": null,
      "candidate_first_name": null,
      "candidate_id": null,
      "candidate_last_name": null,
      "candidate_middle_name": null,
      "candidate_name": null,
      "candidate_office": null,
      "candidate_office_description": null,
      "candidate_office_district": null,
      "candidate_office_state": null,
      "candidate_office_state_full": null,
      "candidate_prefix": null,
      "candidate_suffix": null,
      "category_code": null,
      "category_code_full": null,
      "comm_dt": null,
      "committee_id": "C00500843",
      "committee_name": "WARREN FOR SENATE, INC.",
      "conduit_committee_city": null,
      "conduit_committee_name": null,
      "conduit_committee_state": null,
      "conduit_committee_street1": null,
      "conduit_committee_street2": null,
      "conduit_committee_zip": null,
      "disbursement_amount": 398.18,
      "disbursement_date": "2024-12-31",
      "disbursement_description": "MERCHANT SERVICE FEE",
      "disbursement_purpose_category": "OTHER",
      "disbursement_type": null,
      "disbursement_type_description": null,
      "election_type": "P2030",
      "election_type_full": null,
      "entity_type": "ORG",
      "entity_type_desc": "ORGANIZATION",
      "fec_election_type_desc": "PRIMARY",
      "fec_election_year": "2030",
      "file_number": 1870484,
      "filing_form": "F3",
      "image_number": "202501319748808825",
      "line_number": "17",
      "line_number_label": "Operating Expenditures",
      "link_id": 4013120251139337000,
      "load_date": "2025-02-12T02:36:23",
      "memo_code": null,
      "memo_code_full": null,
      "memo_text": null,
      "memoed_subtotal": false,
      "national_committee_nonfederal_account": null,
      "original_sub_id": null,
      "payee_employer": null,
      "payee_first_name": null,
      "payee_last_name": null,
      "payee_middle_name": null,
      "payee_occupation": null,
      "payee_prefix": null,
      "payee_suffix": null,
      "pdf_url": "https://docquery.fec.gov/cgi-bin/fecimg/?202501319748808825",
      "recipient_city": "SOMERVILLE",
      "recipient_committee_id": null,
      "recipient_name": "ACTBLUE TECHNICAL SERVICES",
      "recipient_state": "MA",
      "recipient_zip": "021443132",
      "ref_disp_excess_flg": null,
      "report_type": "YE",
      "report_year": "2024",
      "schedule_type": "SB",
      "schedule_type_full": "ITEMIZED DISBURSEMENTS",
      "semi_annual_bundled_refund": "0.00",
      "spender_committee_designation": "P",
      "spender_committee_org_type": null,
      "spender_committee_type": "S",
      "sub_id": "4021120251167890650",
      "transaction_id": "500132842",
      "two_year_transaction_period": 2024,
      "unused_recipient_committee_id": null
    },
    {
      "amendment_indicator": "A",
      "amendment_indicator_desc": "ADD",
      "back_reference_schedule_id": null,
      "back_reference_transaction_id": null,
      "beneficiary_committee_name": null,
      "candidate_first_name": null,
      "candidate_id": null,
      "candidate_last_name": null,
      "candidate_middle_name": null,
      "candidate_name": null,
      "candidate_office": null,
      "candidate_office_description": null,
      "candidate_office_district": null,
      "candidate_office_state": null,
      "candidate_office_state_full": null,
      "candidate_prefix": null,
      "candidate_suffix": null,
      "category_code": null,
      "category_code_full": null,
      "comm_dt": null,
      "committee_id": "C00500843",
      "committee_name": "WARREN FOR SENATE, INC.",
      "conduit_committee_city": null,
      "conduit_committee_name": null,
      "conduit_committee_state": null,
      "conduit_committee_street1": null,
      "conduit_committee_street2": null,
      "conduit_committee_zip": null,
      "disbursement_amount": 438.11,
      "disbursement_date": "2024-12-30",
      "disbursement_description": "BANK FEE",
      "disbursement_purpose_category": "OTHER",
      "disbursement_type": null,
      "disbursement_type_description": null,
      "election_type": "P2030",
      "election_type_full": null,
      "entity_type": "ORG",
      "entity_type_desc": "ORGANIZATION",
      "fec_election_type_desc": "PRIMARY",
      "fec_election_year": "2030",
      "file_number": 1870484,
      "filing_form": "F3",
      "image_number": "202501319748808826",
      "line_number": "17",
      "line_number_label": "Operating Expenditures",
      "link_id": 4013120251139337000,
      "load_date": "2025-02-12T02:36:23",
      "memo_code": null,
      "memo_code_full": null,
      "memo_text": null,
      "memoed_subtotal": false,
      "national_committee_nonfederal_account": null,
      "original_sub_id": null,
      "payee_employer": null,
      "payee_first_name": null,
      "payee_last_name": null,
      "payee_middle_name": null,
      "payee_occupation": null,
      "payee_prefix": null,
      "payee_suffix": null,
      "pdf_url": "https://docquery.fec.gov/cgi-bin/fecimg/?202501319748808826",
      "recipient_city": "NEW YORK",
      "recipient_committee_id": null,
      "recipient_name": "AMALGAMATED BANK",
      "recipient_state": "NY",
      "recipient_zip": "100016708",
      "ref_disp_excess_flg": null,
      "report_type": "YE",
      "report_year": "2024",
      "schedule_type": "SB",
      "schedule_type_full": "ITEMIZED DISBURSEMENTS",
      "semi_annual_bundled_refund": "0.00",
      "spender_committee_designation": "P",
      "spender_committee_org_type": null,
      "spender_committee_type": "S",
      "sub_id": "4021120251167890652",
      "transaction_id": "500132799",
      "two_year_transaction_period": 2024,
      "unused_recipient_committee_id": null
    }
  ],
  "source_url": "https://api.open.fec.gov/v1/schedules/schedule_b/?committee_id=C00500843&two_year_transaction_period=2024&sort=-disbursement_date&per_page=3",
  "total_count": 7879,
  "withheld_individual_refunds": 0
}
```

### Filings

- Capability: `records/filings`
- Description: Reports and statements filed with the FEC (F3/F3P/F3X financial reports, F24/F5 independent-expenditure reports, F1/F2 registrations and others), newest receipt first. Filter by committee, candidate, filer name, form, report type, report year, cycle, receipt date range or most-recent version. Rows include coverage dates, summary totals, amendment state and links to the filed PDF, HTML, .fec and CSV.
- Instructions: List a committee's or candidate's FEC filings, find the latest quarterly report, or get links to the filed documents.
- Cost: 5 credits per call
- Capability file: [Filings](https://firecrawl.dev/alexandria/agents/providers/fec-gov/records/filings)

Accepted options:
- `api_key` (string): api.data.gov key for the FEC API, normally supplied by the calling platform. Sent only as the X-Api-Key header; never placed in URLs or output. Omitted, the call uses api.data.gov's public DEMO_KEY (10 requests per hour per IP) and returns a demo_key warning. Pattern: ^[A-Za-z0-9]{20,64}$. Example: `<api_key>`
- `candidate_id` (string): FEC candidate ID, e.g. S2MA00170 (H House, S Senate, P President). Pattern: ^[HSPhsp][0-9A-Za-z]{8}$. Example: `<candidate_id>`
- `committee_id` (string): FEC committee ID, e.g. C00500843. Pattern: ^[Cc][0-9]{8}$. Example: `<committee_id>`
- `cycle` (number): Two-year election cycle, named by its even year: 2024 covers 2023-2024. Example: `1976`
- `filer_name` (string): Filer name search. Pattern: \S. Example: `<filer_name>`
- `form_type` (string): FEC form, e.g. F3, F3X, F3P, F24, F5, F1, F2, F99. Pattern: ^[A-Za-z0-9]{2,6}$. Example: `<form_type>`
- `max_receipt_date` (string): Latest FEC receipt date, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<max_receipt_date>`
- `min_receipt_date` (string): Earliest FEC receipt date, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<min_receipt_date>`
- `most_recent` (boolean): Only the latest version of each report (excludes superseded amendments). Example: `false`
- `page` (number): 1-based page; pass the previous next_page with the same filters. Example: `1`
- `per_page` (number): Rows per page, 1 to 100. Example: `10`
- `report_type` (string): Report code, e.g. Q1, Q2, Q3, YE, M7, 12G, 30G, 48. Pattern: ^[A-Za-z0-9]{1,4}$. Example: `<report_type>`
- `report_year` (number): report_year Example: `1976`

Response schema example:
```json
{
  "count_is_exact": true,
  "next_page": 2,
  "observed_at_ms": 1791423292000,
  "page": 1,
  "per_page": 3,
  "records": [
    {
      "additional_bank_names": null,
      "amendment_chain": [
        1870484
      ],
      "amendment_indicator": "N",
      "amendment_version": 0,
      "bank_depository_city": null,
      "bank_depository_name": null,
      "bank_depository_state": null,
      "bank_depository_street_1": null,
      "bank_depository_street_2": null,
      "bank_depository_zip": null,
      "beginning_image_number": "202501319748808717",
      "candidate_id": null,
      "candidate_name": null,
      "cash_on_hand_beginning_period": 3563731.14,
      "cash_on_hand_end_period": 3450046.67,
      "committee_id": "C00500843",
      "committee_name": "WARREN FOR SENATE, INC.",
      "committee_type": "S",
      "coverage_end_date": "2024-12-31",
      "coverage_start_date": "2024-11-26",
      "csv_url": "https://docquery.fec.gov/csv/484/1870484.csv",
      "cycle": 2024,
      "debts_owed_by_committee": 0,
      "debts_owed_to_committee": 0,
      "document_description": "YEAR-END 2024",
      "document_type": null,
      "document_type_full": null,
      "election_year": null,
      "ending_image_number": "202501319748808918",
      "fec_file_id": "FEC-1870484",
      "fec_url": "https://docquery.fec.gov/dcdev/posted/1870484.fec",
      "file_number": 1870484,
      "form_category": "REPORT",
      "form_type": "F3",
      "house_personal_funds": null,
      "html_url": "https://docquery.fec.gov/cgi-bin/forms/C00500843/1870484/",
      "is_amended": false,
      "means_filed": "e-file",
      "most_recent": true,
      "most_recent_file_number": 1870484,
      "net_donations": null,
      "office": "S",
      "opposition_personal_funds": null,
      "pages": 202,
      "party": null,
      "pdf_url": "https://docquery.fec.gov/pdf/717/202501319748808717/202501319748808717.pdf",
      "previous_file_number": 1870484,
      "primary_general_indicator": "P",
      "receipt_date": "2025-01-31T00:00:00",
      "report_type": "YE",
      "report_type_full": "YEAR-END",
      "report_year": 2024,
      "request_type": null,
      "senate_personal_funds": null,
      "state": null,
      "sub_id": "4013120251139337243",
      "total_communication_cost": null,
      "total_disbursements": 292437.62,
      "total_independent_expenditures": null,
      "total_individual_contributions": null,
      "total_receipts": 178753.15,
      "treasurer_name": "EGERMAN, PAUL",
      "update_date": "2025-01-31"
    },
    {
      "additional_bank_names": null,
      "amendment_chain": [
        1857375,
        1861883
      ],
      "amendment_indicator": "A",
      "amendment_version": 1,
      "bank_depository_city": null,
      "bank_depository_name": null,
      "bank_depository_state": null,
      "bank_depository_street_1": null,
      "bank_depository_street_2": null,
      "bank_depository_zip": null,
      "beginning_image_number": "202501079740072862",
      "candidate_id": null,
      "candidate_name": null,
      "cash_on_hand_beginning_period": 5471593.51,
      "cash_on_hand_end_period": 3563731.14,
      "committee_id": "C00500843",
      "committee_name": "WARREN FOR SENATE, INC.",
      "committee_type": "S",
      "coverage_end_date": "2024-11-25",
      "coverage_start_date": "2024-10-17",
      "csv_url": "https://docquery.fec.gov/csv/883/1861883.csv",
      "cycle": 2024,
      "debts_owed_by_committee": 0,
      "debts_owed_to_committee": 0,
      "document_description": "POST-GENERAL 2024",
      "document_type": null,
      "document_type_full": null,
      "election_year": null,
      "ending_image_number": "202501079740076588",
      "fec_file_id": "FEC-1861883",
      "fec_url": "https://docquery.fec.gov/dcdev/posted/1861883.fec",
      "file_number": 1861883,
      "form_category": "REPORT",
      "form_type": "F3",
      "house_personal_funds": null,
      "html_url": "https://docquery.fec.gov/cgi-bin/forms/C00500843/1861883/",
      "is_amended": false,
      "means_filed": "e-file",
      "most_recent": true,
      "most_recent_file_number": 1861883,
      "net_donations": null,
      "office": "S",
      "opposition_personal_funds": null,
      "pages": 3727,
      "party": null,
      "pdf_url": "https://docquery.fec.gov/pdf/862/202501079740072862/202501079740072862.pdf",
      "previous_file_number": 1857375,
      "primary_general_indicator": "P",
      "receipt_date": "2025-01-07T00:00:00",
      "report_type": "30G",
      "report_type_full": "POST-GENERAL",
      "report_year": 2024,
      "request_type": null,
      "senate_personal_funds": null,
      "state": null,
      "sub_id": "4010720251127074016",
      "total_communication_cost": null,
      "total_disbursements": 2357100.54,
      "total_independent_expenditures": null,
      "total_individual_contributions": null,
      "total_receipts": 449238.17,
      "treasurer_name": "EGERMAN, PAUL",
      "update_date": "2025-01-07"
    },
    {
      "additional_bank_names": null,
      "amendment_chain": [
        1857375
      ],
      "amendment_indicator": "N",
      "amendment_version": 0,
      "bank_depository_city": null,
      "bank_depository_name": null,
      "bank_depository_state": null,
      "bank_depository_street_1": null,
      "bank_depository_street_2": null,
      "bank_depository_zip": null,
      "beginning_image_number": "202412059731299514",
      "candidate_id": null,
      "candidate_name": null,
      "cash_on_hand_beginning_period": 5471593.51,
      "cash_on_hand_end_period": 3563731.14,
      "committee_id": "C00500843",
      "committee_name": "WARREN FOR SENATE, INC.",
      "committee_type": "S",
      "coverage_end_date": "2024-11-25",
      "coverage_start_date": "2024-10-17",
      "csv_url": "https://docquery.fec.gov/csv/375/1857375.csv",
      "cycle": 2024,
      "debts_owed_by_committee": 0,
      "debts_owed_to_committee": 0,
      "document_description": "POST-GENERAL 2024",
      "document_type": null,
      "document_type_full": null,
      "election_year": null,
      "ending_image_number": "202412059731303240",
      "fec_file_id": "FEC-1857375",
      "fec_url": "https://docquery.fec.gov/dcdev/posted/1857375.fec",
      "file_number": 1857375,
      "form_category": "REPORT",
      "form_type": "F3",
      "house_personal_funds": null,
      "html_url": "https://docquery.fec.gov/cgi-bin/forms/C00500843/1857375/",
      "is_amended": true,
      "means_filed": "e-file",
      "most_recent": false,
      "most_recent_file_number": 1861883,
      "net_donations": null,
      "office": "S",
      "opposition_personal_funds": null,
      "pages": 3727,
      "party": null,
      "pdf_url": "https://docquery.fec.gov/pdf/514/202412059731299514/202412059731299514.pdf",
      "previous_file_number": 1857375,
      "primary_general_indicator": "P",
      "receipt_date": "2024-12-05T00:00:00",
      "report_type": "30G",
      "report_type_full": "POST-GENERAL",
      "report_year": 2024,
      "request_type": null,
      "senate_personal_funds": null,
      "state": null,
      "sub_id": "4120520241074539584",
      "total_communication_cost": null,
      "total_disbursements": 2357100.54,
      "total_independent_expenditures": null,
      "total_individual_contributions": null,
      "total_receipts": 449238.17,
      "treasurer_name": "EGERMAN, PAUL",
      "update_date": "2024-12-05"
    }
  ],
  "source_url": "https://api.open.fec.gov/v1/filings/?committee_id=C00500843&form_type=F3&report_year=2024&sort=-receipt_date&page=1&per_page=3",
  "total_count": 8,
  "total_pages": 3
}
```

### Independent expenditures

- Capability: `records/independent_expenditures`
- Description: Independent expenditures (FEC Schedule E): spending by super PACs, PACs, parties and others expressly for or against a federal candidate, with spender, candidate, support or oppose, amount, expenditure and dissemination dates, payee and purpose. Filter by spender, candidate, support/oppose, cycle, candidate office/state/party, payee, date and amount ranges; newest first or by amount.
- Instructions: Who spent independently for or against a candidate and how much, or what a super PAC spent on which races.
- Cost: 5 credits per call
- Capability file: [Independent expenditures](https://firecrawl.dev/alexandria/agents/providers/fec-gov/records/independent_expenditures)

Accepted options:
- `api_key` (string): api.data.gov key for the FEC API, normally supplied by the calling platform. Sent only as the X-Api-Key header; never placed in URLs or output. Omitted, the call uses api.data.gov's public DEMO_KEY (10 requests per hour per IP) and returns a demo_key warning. Pattern: ^[A-Za-z0-9]{20,64}$. Example: `<api_key>`
- `candidate_id` (string): FEC candidate ID, e.g. S2MA00170 (H House, S Senate, P President). Pattern: ^[HSPhsp][0-9A-Za-z]{8}$. Example: `<candidate_id>`
- `candidate_office` (string): H House, S Senate, P President. Example: `H`
- `candidate_office_state` (string): Two-letter US state or territory code, e.g. MA. Pattern: ^[A-Za-z]{2}$. Example: `<candidate_office_state>`
- `candidate_party` (string): Three-letter FEC party code, e.g. DEM, REP, LIB, GRE, IND. Pattern: ^[A-Za-z0-9]{3}$. Example: `<candidate_party>`
- `committee_id` (string): Spending committee. Pattern: ^[Cc][0-9]{8}$. Example: `<committee_id>`
- `cursor` (string): next_cursor from the previous call. Keep the same filters and sort. Pattern: ^last_index=[A-Za-z0-9.:_-]{1,40}(&[a-z_]+=[A-Za-z0-9.:_-]{1,40}){0,5}$|^[a-z_]+=[A-Za-z0-9.:_-]{1,40}(&[a-z_]+=[A-Za-z0-9.:_-]{1,40}){1,5}$. Example: `<cursor>`
- `cycle` (number): Two-year election cycle, named by its even year: 2024 covers 2023-2024. Example: `1976`
- `max_amount` (number): Maximum amount in dollars. Example: `10`
- `max_date` (string): Latest expenditure date, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<max_date>`
- `min_amount` (number): Minimum amount in dollars. Example: `10`
- `min_date` (string): Earliest expenditure date, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `<min_date>`
- `most_recent` (boolean): Only the latest version of each expenditure (excludes superseded amendments). Example: `false`
- `payee_name` (string): Payee (vendor) name search. Pattern: \S. Example: `<payee_name>`
- `per_page` (number): Rows per page, 1 to 100. Example: `10`
- `sort` (string): sort Example: `-expenditure_date`
- `support_oppose` (string): S support, O oppose. Example: `S`

Response schema example:
```json
{
  "count_is_exact": true,
  "next_cursor": "last_index=4041820251185452866&last_expenditure_date=2024-12-30",
  "observed_at_ms": 1791423299000,
  "per_page": 3,
  "records": [
    {
      "action_code": "A",
      "action_code_full": "ADD",
      "amendment_indicator": "N",
      "amendment_number": null,
      "back_reference_schedule_name": null,
      "back_reference_transaction_id": null,
      "candidate_first_name": "DONALD",
      "candidate_id": "P80001571",
      "candidate_last_name": "TRUMP",
      "candidate_middle_name": "J",
      "candidate_name": "TRUMP, DONALD J",
      "candidate_office": "P",
      "candidate_office_district": "00",
      "candidate_office_state": "AZ",
      "candidate_party": "REP",
      "candidate_prefix": null,
      "candidate_suffix": null,
      "category_code": null,
      "category_code_full": null,
      "committee_id": "C00804856",
      "committee_name": "REPUBLICAN ACCOUNTABILITY PAC",
      "conduit_committee_city": null,
      "conduit_committee_id": null,
      "conduit_committee_name": null,
      "conduit_committee_state": null,
      "conduit_committee_street1": null,
      "conduit_committee_street2": null,
      "conduit_committee_zip": null,
      "disbursement_dt": "3024-07-18",
      "dissemination_date": "2024-07-17",
      "election_type": "G2024",
      "election_type_full": null,
      "expenditure_amount": 100,
      "expenditure_date": "3024-07-18",
      "expenditure_description": "ADVERTISING - EXTREMEREACH AZ",
      "file_number": 1804207,
      "filer_first_name": "SARAH",
      "filer_last_name": "LONGWELL",
      "filer_middle_name": null,
      "filer_prefix": null,
      "filer_suffix": null,
      "filing_date": "2024-07-19",
      "filing_form": "F24",
      "form_line_number": "F24-24",
      "image_number": "202407199661322773",
      "independent_sign_date": "2024-07-19",
      "independent_sign_name": "LONGWELL, SARAH",
      "is_notice": true,
      "line_number": "24",
      "link_id": 4071920241978104000,
      "memo_code": null,
      "memo_code_full": null,
      "memo_text": null,
      "memoed_subtotal": false,
      "most_recent": true,
      "notary_commission_expiration_date": null,
      "notary_sign_date": null,
      "notary_sign_name": null,
      "office_total_ytd": 112395.99,
      "original_sub_id": null,
      "payee_city": "CHICAGO",
      "payee_first_name": null,
      "payee_last_name": null,
      "payee_middle_name": null,
      "payee_name": "EXTREME REACH, INC.",
      "payee_prefix": null,
      "payee_state": "IL",
      "payee_street_1": "28540 NETWORK PL",
      "payee_street_2": null,
      "payee_suffix": null,
      "payee_zip": "606731285",
      "pdf_url": "https://docquery.fec.gov/cgi-bin/fecimg/?202407199661322773",
      "previous_file_number": 1804207,
      "report_type": "48",
      "report_year": "2024",
      "schedule_type": "SE",
      "schedule_type_full": "ITEMIZED INDEPENDENT EXPENDITURES",
      "sub_id": "4071920241978247524",
      "support_oppose_indicator": "O",
      "transaction_id": "EE816D93A28994F39BD3"
    },
    {
      "action_code": "C",
      "action_code_full": "CHANGE",
      "amendment_indicator": "A",
      "amendment_number": null,
      "back_reference_schedule_name": null,
      "back_reference_transaction_id": null,
      "candidate_first_name": "KAMALA",
      "candidate_id": "P00009423",
      "candidate_last_name": "HARRIS",
      "candidate_middle_name": "D.",
      "candidate_name": "HARRIS, KAMALA D. HON.",
      "candidate_office": "P",
      "candidate_office_district": "00",
      "candidate_office_state": "US",
      "candidate_party": "DEM",
      "candidate_prefix": "HON.",
      "candidate_suffix": null,
      "category_code": null,
      "category_code_full": null,
      "committee_id": "C00804856",
      "committee_name": "REPUBLICAN ACCOUNTABILITY PAC",
      "conduit_committee_city": null,
      "conduit_committee_id": null,
      "conduit_committee_name": null,
      "conduit_committee_state": null,
      "conduit_committee_street1": null,
      "conduit_committee_street2": null,
      "conduit_committee_zip": null,
      "disbursement_dt": "2024-12-30",
      "dissemination_date": "2024-10-16",
      "election_type": "G2024",
      "election_type_full": null,
      "expenditure_amount": 194.46,
      "expenditure_date": "2024-12-30",
      "expenditure_description": "PMT FOR EST FROM 10/16/2024. ADVERTISING-YOUTUBE JIM ACTUAL 10/16/2024",
      "file_number": 1888979,
      "filer_first_name": "SARAH",
      "filer_last_name": "LONGWELL",
      "filer_middle_name": null,
      "filer_prefix": null,
      "filer_suffix": null,
      "filing_date": "2025-04-18",
      "filing_form": "F3X",
      "form_line_number": "F3X-24",
      "image_number": "202504189756123165",
      "independent_sign_date": "2025-04-01",
      "independent_sign_name": "LONGWELL, SARAH",
      "is_notice": false,
      "line_number": "24",
      "link_id": 4041820251185330000,
      "memo_code": null,
      "memo_code_full": null,
      "memo_text": null,
      "memoed_subtotal": false,
      "most_recent": true,
      "notary_commission_expiration_date": null,
      "notary_sign_date": null,
      "notary_sign_name": null,
      "office_total_ytd": 34334818.98,
      "original_sub_id": null,
      "payee_city": "SAN FRANCISCO",
      "payee_first_name": null,
      "payee_last_name": null,
      "payee_middle_name": null,
      "payee_name": "GOOGLE LLC",
      "payee_prefix": null,
      "payee_state": "CA",
      "payee_street_1": "PO BOX 39000",
      "payee_street_2": null,
      "payee_suffix": null,
      "payee_zip": "941390001",
      "pdf_url": "https://docquery.fec.gov/cgi-bin/fecimg/?202504189756123165",
      "previous_file_number": 1868806,
      "report_type": "YE",
      "report_year": "2024",
      "schedule_type": "SE",
      "schedule_type_full": "ITEMIZED INDEPENDENT EXPENDITURES",
      "sub_id": "4041820251185452867",
      "support_oppose_indicator": "S",
      "transaction_id": "E45EAD535BE6D4469910"
    },
    {
      "action_code": "C",
      "action_code_full": "CHANGE",
      "amendment_indicator": "A",
      "amendment_number": null,
      "back_reference_schedule_name": null,
      "back_reference_transaction_id": null,
      "candidate_first_name": "DONALD",
      "candidate_id": "P80001571",
      "candidate_last_name": "TRUMP",
      "candidate_middle_name": "J",
      "candidate_name": "TRUMP, DONALD J",
      "candidate_office": "P",
      "candidate_office_district": "00",
      "candidate_office_state": "US",
      "candidate_party": "REP",
      "candidate_prefix": null,
      "candidate_suffix": null,
      "category_code": null,
      "category_code_full": null,
      "committee_id": "C00804856",
      "committee_name": "REPUBLICAN ACCOUNTABILITY PAC",
      "conduit_committee_city": null,
      "conduit_committee_id": null,
      "conduit_committee_name": null,
      "conduit_committee_state": null,
      "conduit_committee_street1": null,
      "conduit_committee_street2": null,
      "conduit_committee_zip": null,
      "disbursement_dt": "2024-12-30",
      "dissemination_date": "2024-10-20",
      "election_type": "G2024",
      "election_type_full": null,
      "expenditure_amount": 17666.46,
      "expenditure_date": "2024-12-30",
      "expenditure_description": "PMT FOR EST FROM 10/20/2024. ADVERTISING-YOUTUBE ACTUAL 10/20/2024",
      "file_number": 1888979,
      "filer_first_name": "SARAH",
      "filer_last_name": "LONGWELL",
      "filer_middle_name": null,
      "filer_prefix": null,
      "filer_suffix": null,
      "filing_date": "2025-04-18",
      "filing_form": "F3X",
      "form_line_number": "F3X-24",
      "image_number": "202504189756123164",
      "independent_sign_date": "2025-04-01",
      "independent_sign_name": "LONGWELL, SARAH",
      "is_notice": false,
      "line_number": "24",
      "link_id": 4041820251185330000,
      "memo_code": null,
      "memo_code_full": null,
      "memo_text": null,
      "memoed_subtotal": false,
      "most_recent": true,
      "notary_commission_expiration_date": null,
      "notary_sign_date": null,
      "notary_sign_name": null,
      "office_total_ytd": 34334818.98,
      "original_sub_id": null,
      "payee_city": "SAN FRANCISCO",
      "payee_first_name": null,
      "payee_last_name": null,
      "payee_middle_name": null,
      "payee_name": "GOOGLE LLC",
      "payee_prefix": null,
      "payee_state": "CA",
      "payee_street_1": "PO BOX 39000",
      "payee_street_2": null,
      "payee_suffix": null,
      "payee_zip": "941390001",
      "pdf_url": "https://docquery.fec.gov/cgi-bin/fecimg/?202504189756123164",
      "previous_file_number": 1868806,
      "report_type": "YE",
      "report_year": "2024",
      "schedule_type": "SE",
      "schedule_type_full": "ITEMIZED INDEPENDENT EXPENDITURES",
      "sub_id": "4041820251185452866",
      "support_oppose_indicator": "O",
      "transaction_id": "E26B622C6374C41F78B2"
    }
  ],
  "source_url": "https://api.open.fec.gov/v1/schedules/schedule_e/?committee_id=C00804856&cycle=2024&sort=-expenditure_date&per_page=3",
  "total_count": 3851
}
```

### Receipt aggregates

- Capability: `records/receipt_aggregates`
- Description: Aggregated individual contributions to one committee for a cycle, by contribution size (five buckets; the $200-and-under bucket includes unitemized money), by contributor state, or by contributor employer: total dollars and contribution count per bucket. Aggregates only; no contributor names.
- Instructions: Where a committee's individual money comes from: small versus large donors, top states or top employers.
- Cost: 5 credits per call
- Capability file: [Receipt aggregates](https://firecrawl.dev/alexandria/agents/providers/fec-gov/records/receipt_aggregates)

Accepted options:
- `api_key` (string): api.data.gov key for the FEC API, normally supplied by the calling platform. Sent only as the X-Api-Key header; never placed in URLs or output. Omitted, the call uses api.data.gov's public DEMO_KEY (10 requests per hour per IP) and returns a demo_key warning. Pattern: ^[A-Za-z0-9]{20,64}$. Example: `<api_key>`
- `by` (string, required): size, state or employer. Example: `size`
- `committee_id` (string, required): FEC committee ID, e.g. C00500843. Pattern: ^[Cc][0-9]{8}$. Example: `<committee_id>`
- `cycle` (number): Two-year election cycle, named by its even year: 2024 covers 2023-2024. Example: `1976`
- `employer` (string): by=employer only: employer name search. Pattern: \S. Example: `<employer>`
- `page` (number): 1-based page; pass the previous next_page with the same filters. Example: `1`
- `per_page` (number): Rows per page, 1 to 100. Example: `10`
- `state` (string): by=state only: one state. Pattern: ^[A-Za-z]{2}$. Example: `<state>`

Response schema example:
```json
{
  "count_is_exact": true,
  "next_page": 2,
  "observed_at_ms": 1791423306000,
  "page": 1,
  "per_page": 3,
  "records": [
    {
      "committee_id": "C00500843",
      "count": 19195,
      "cycle": 2024,
      "state": "MA",
      "state_full": "Massachusetts",
      "total": 1156946.76
    },
    {
      "committee_id": "C00500843",
      "count": 23613,
      "cycle": 2024,
      "state": "CA",
      "state_full": "California",
      "total": 756801.4
    },
    {
      "committee_id": "C00500843",
      "count": 9335,
      "cycle": 2024,
      "state": "NY",
      "state_full": "New York",
      "total": 312913.66
    }
  ],
  "source_url": "https://api.open.fec.gov/v1/schedules/schedule_a/by_state/?committee_id=C00500843&cycle=2024&sort=-total&page=1&per_page=3",
  "total_count": 57,
  "total_pages": 19
}
```
