---
title: "GET /v1/committee/{committee_id}/totals/"
method: GET
path: "/v1/committee/{committee_id}/totals/"
tags: ["financial"]
---

# GET /v1/committee/{committee_id}/totals/

`GET /v1/committee/{committee_id}/totals/`

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

This endpoint provides information about a committee's Form 3, Form 3X, or Form 3P financial reports,
which are aggregated by two-year period. We refer to two-year periods as a `cycle`.

The cycle is named after the even-numbered year and includes the year before it. To obtain
totals from 2013 and 2014, you would use 2014. In odd-numbered years, the current cycle
is the next year — for example, in 2015, the current cycle is 2016.

For presidential and Senate candidates, multiple two-year cycles exist between elections.

## Path parameters

- `committee_id` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `cycle` integer[]
- `sort` string
- `sort_hide_null` boolean
- `sort_null_only` boolean
- `sort_nulls_last` boolean
- `api_key` string

## Response `default`

Default response

- CommitteeTotalsPage
  - `pagination` OffsetInfo
    - `count` integer
    - `is_count_exact` boolean
    - `page` integer
    - `pages` integer
    - `per_page` integer
  - `results` CommitteeTotals[]
    - `all_loans_received` number
    - `all_other_loans` number
    - `allocated_federal_election_levin_share` number
    - `candidate_contribution` number
    - `cash_on_hand_beginning_period` number
    - `committee_designation` string, nullable: The one-letter designation code of the organization: - A authorized by a candidate - J joint fundraising committee - P principal campaign committee of a candidate - U unauthorized - B lobbyist/registrant PAC - D leadership PAC
    - `committee_designation_full` string, nullable: The one-letter designation code of the organization: - A authorized by a candidate - J joint fundraising committee - P principal campaign committee of a candidate - U unauthorized - B lobbyist/registrant PAC - D leadership PAC
    - `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_type` string, nullable: The one-letter type code of the organization: - C communication cost - D delegate - E electioneering communication - H house - I independent expenditure filer (not a committee) - N PAC - nonqualified - O independent expenditure-only (super PACs) - P presidential - Q PAC - qualified - S senate - U single candidate independent expenditure - V PAC with non-contribution account, nonqualified - W PAC with non-contribution account, qualified - X party, nonqualified - Y party, qualified - Z national party non-federal account
    - `committee_type_full` string, nullable: The one-letter type code of the organization: - C communication cost - D delegate - E electioneering communication - H house - I independent expenditure filer (not a committee) - N PAC - nonqualified - O independent expenditure-only (super PACs) - P presidential - Q PAC - qualified - S senate - U single candidate independent expenditure - V PAC with non-contribution account, nonqualified - W PAC with non-contribution account, qualified - X party, nonqualified - Y party, qualified - Z national party non-federal account
    - `contribution_refunds` number
    - `contributions` number
    - `contributions_ie_and_party_expenditures_made_percent` number
    - `convention_exp` number
    - `coordinated_expenditures_by_party_committee` number
    - `coverage_end_date` string, date-time, nullable
    - `coverage_start_date` string, date-time, nullable
    - `cycle` integer, required: Filter records to only those that are applicable to a given two-year period. This cycle follows the traditional House election cycle and subdivides the presidential and Senate elections into comparable two-year blocks. The cycle begins with an odd year and is named for its ending, even year.
    - `disbursements` number
    - `exempt_legal_accounting_disbursement` number
    - `exp_prior_years_subject_limits` number
    - `exp_subject_limits` number
    - `fed_candidate_committee_contributions` number
    - `fed_candidate_contribution_refunds` number
    - `fed_disbursements` number
    - `fed_election_activity` number
    - `fed_operating_expenditures` number
    - `fed_receipts` number
    - `federal_funds` number
    - `filing_frequency` string, nullable: The one-letter code of the filing frequency: - A Administratively terminated - D Debt - M Monthly filer - Q Quarterly filer - T Terminated - W Waived
    - `filing_frequency_full` string, nullable: The one-letter code of the filing frequency: - A Administratively terminated - D Debt - M Monthly filer - Q Quarterly filer - T Terminated - W Waived
    - `first_f1_date` string, date, nullable: The day the FEC received the committee's first Form 1
    - `first_file_date` string, date, nullable: The day the FEC received the committee's first filing. This is usually a Form 1 committee registration.
    - `fundraising_disbursements` number
    - `independent_expenditures` number
    - `individual_contributions` number
    - `individual_contributions_percent` number
    - `individual_itemized_contributions` number
    - `individual_unitemized_contributions` number
    - `itemized_convention_exp` number
    - `itemized_other_disb` number
    - `itemized_other_income` number
    - `itemized_other_refunds` number
    - `itemized_refunds_relating_convention_exp` number
    - `last_beginning_image_number` string
    - `last_cash_on_hand_end_period` number
    - `last_debts_owed_by_committee` number
    - `last_debts_owed_to_committee` number
    - `last_report_type_full` string, nullable
    - `last_report_year` integer, nullable
    - `loan_repayments` number
    - `loan_repayments_candidate_loans` number
    - `loan_repayments_made` number
    - `loan_repayments_other_loans` number
    - `loan_repayments_received` number
    - `loans` number
    - `loans_and_loan_repayments_made` number
    - `loans_and_loan_repayments_received` number
    - `loans_made` number
    - `loans_made_by_candidate` number
    - `loans_received` number
    - `loans_received_from_candidate` number
    - `net_contributions` number
    - `net_operating_expenditures` number
    - `non_allocated_fed_election_activity` number
    - `offsets_to_fundraising_expenditures` number
    - `offsets_to_legal_accounting` number
    - `offsets_to_operating_expenditures` number
    - `operating_expenditures` number
    - `operating_expenditures_percent` number
    - `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
    - `organization_type_full` 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
    - `other_disbursements` number
    - `other_fed_operating_expenditures` number
    - `other_fed_receipts` number
    - `other_loans_received` number
    - `other_political_committee_contributions` number
    - `other_receipts` number
    - `other_refunds` number
    - `party_and_other_committee_contributions_percent` number
    - `party_full` string, nullable: Party affiliated with a candidate or committee
    - `pdf_url` string
    - `political_party_committee_contributions` number
    - `receipts` number
    - `refunded_individual_contributions` number
    - `refunded_other_political_committee_contributions` number
    - `refunded_political_party_committee_contributions` number
    - `refunds_relating_convention_exp` number
    - `repayments_loans_made_by_candidate` number
    - `repayments_other_loans` number
    - `report_form` string
    - `shared_fed_activity` number
    - `shared_fed_activity_nonfed` number
    - `shared_fed_operating_expenditures` number
    - `shared_nonfed_operating_expenditures` number
    - `sponsor_candidate_ids` 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. This is a filter for Leadership PAC sponsor.
    - `sponsor_candidate_list` PacSponsorCandidate[]
      - `sponsor_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.
      - `sponsor_candidate_name` string, nullable: Name of candidate running for office
    - `total_exp_subject_limits` number
    - `total_independent_contributions` number
    - `total_independent_expenditures` number
    - `total_offsets_to_operating_expenditures` number
    - `total_transfers` number
    - `transaction_coverage_date` string, date
    - `transfers_from_affiliated_committee` number
    - `transfers_from_affiliated_party` number
    - `transfers_from_nonfed_account` number
    - `transfers_from_nonfed_levin` number
    - `transfers_from_other_authorized_committee` number
    - `transfers_to_affiliated_committee` number
    - `transfers_to_other_authorized_committee` number
    - `treasurer_name` string, nullable: Name of the Committee's treasurer. If multiple treasurers for the committee, the most recent treasurer will be shown.
    - `unitemized_convention_exp` number
    - `unitemized_other_disb` number
    - `unitemized_other_income` number
    - `unitemized_other_refunds` number
    - `unitemized_refunds_relating_convention_exp` number

---

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