---
title: "GET /v1/candidates/totals/aggregates/"
method: GET
path: "/v1/candidates/totals/aggregates/"
tags: ["candidate"]
---

# GET /v1/candidates/totals/aggregates/

`GET /v1/candidates/totals/aggregates/`

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

Candidate total receipts and disbursements aggregated by `aggregate_by`.

## Query parameters

- `page` integer
- `per_page` integer
- `election_year` integer[]
- `office` '' | 'H' | 'S' | 'P'
- `is_active_candidate` boolean
- `election_full` boolean
- `min_election_cycle` integer
- `max_election_cycle` integer
- `state` string[]
- `district` string[]
- `party` '' | 'DEM' | 'REP' | 'OTHER'
- `aggregate_by` 'office' | 'office-state' | 'office-state-district' | 'office-party'
- `sort` string[]
- `sort_hide_null` boolean
- `sort_null_only` boolean
- `sort_nulls_last` boolean
- `api_key` string

## Response `default`

Default response

- CandidateTotalAggregatePage
  - `pagination` OffsetInfo
    - `count` integer
    - `is_count_exact` boolean
    - `page` integer
    - `pages` integer
    - `per_page` integer
  - `results` CandidateTotalAggregate[]
    - `district` string
    - `district_number` integer
    - `election_year` integer
    - `office` string
    - `party` string
    - `state` string
    - `state_full` string
    - `total_cash_on_hand_end_period` number
    - `total_debts_owed_by_committee` number
    - `total_disbursements` number
    - `total_individual_itemized_contributions` number
    - `total_other_political_committee_contributions` number
    - `total_receipts` number
    - `total_transfers_from_other_authorized_committee` 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)