openfec_get_committee_totals
Declared read-onlyShow server-provided details
Openfec Get Committee Totals
Server description (copied; language not verified)
Get pre-aggregated committee financial totals — receipts, disbursements, cash on hand, debts, and the itemized/unitemized breakdown — without paginating Schedule A. Use mode "single" (the default) with a committee_id for one committee's totals, one row per two-year cycle it has filed. Use mode "by_entity_type" to rank or screen every committee of one type (presidential, pac, party, pac-party, house-senate, ie-only) by state, designation, or a receipts/disbursements threshold.
Input schema (server-provided preview — do not copy)
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"mode": {
"enum": [
"single",
"by_entity_type"
],
"type": "string",
"default": "single",
"description": "Query mode. \"single\" returns one committee's totals, one row per cycle. \"by_entity_type\" returns a page of committees of one entity type, filterable and sortable across committees."
},
"page": {
"type": "integer",
"default": 1,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (1-indexed). Read pagination.pages in the response to see how many pages exist — a long-running committee can have more cycles than one page holds."
},
"sort": {
"enum": [
"cycle",
"-cycle",
"receipts",
"-receipts",
"disbursements",
"-disbursements",
"last_cash_on_hand_end_period",
"-last_cash_on_hand_end_period"
],
"type": "string",
"description": "Sort field. A \"-\" prefix sorts descending: \"-receipts\" ranks the biggest fundraisers first in by_entity_type mode, \"-cycle\" puts a committee's most recent cycle first in single mode."
},
"cycle": {
"type": "number",
"description": "Two-year election cycle (e.g., 2024). Even years only. Omit in single mode to get every cycle the committee has filed."
},
"per_page": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Results per page."
},
"entity_type": {
"enum": [
"presidential",
"pac",
"party",
"pac-party",
"house-senate",
"ie-only"
],
"type": "string",
"description": "Committee entity type for the grouped search. Required in by_entity_type mode. house-senate covers both chambers as one group; ie-only is committees that report only independent expenditures."
},
"committee_id": {
"type": "string",
"description": "Committee ID (e.g., C00703975). Get IDs from openfec_search_committees results. Required in single mode; in by_entity_type mode it narrows the grouped search to that one committee."
},
"max_receipts": {
"type": "number",
"description": "Maximum total receipts in dollars. by_entity_type mode only."
},
"min_receipts": {
"type": "number",
"description": "Minimum total receipts in dollars. by_entity_type mode only."
},
"committee_type": {
"type": "string",
"description": "Committee type code — H (House), S (Senate), P (Presidential), O (Super PAC), N/Q (PAC), X/Y (party). by_entity_type mode only."
},
"committee_state": {
"type": "string",
"description": "Two-letter state code of the committee. by_entity_type mode only."
},
"max_disbursements": {
"type": "number",
"description": "Maximum total disbursements in dollars. by_entity_type mode only."
},
"min_disbursements": {
"type": "number",
"description": "Minimum total disbursements in dollars. by_entity_type mode only."
},
"organization_type": {
"type": "string",
"description": "Sponsoring organization type — C (corporation), L (labor), M (membership), T (trade), V (cooperative), W (corporation without capital stock). by_entity_type mode only."
},
"committee_designation": {
"type": "string",
"description": "Committee designation — A (authorized), B (lobbyist PAC), D (leadership PAC), J (joint fundraiser), P (principal campaign), U (unauthorized). by_entity_type mode only."
}
},
"additionalProperties": false
}