---
title: "GET /v1/electioneering/totals/by_candidate/"
method: GET
path: "/v1/electioneering/totals/by_candidate/"
tags: ["electioneering"]
---

# GET /v1/electioneering/totals/by_candidate/

`GET /v1/electioneering/totals/by_candidate/`

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

Total electioneering communications spent on candidates by cycle
or candidate election year

## Query parameters

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

## Response `default`

Default response

- ECTotalsByCandidatePage
  - `pagination` OffsetInfo
    - `count` integer
    - `is_count_exact` boolean
    - `page` integer
    - `pages` integer
    - `per_page` integer
  - `results` ECTotalsByCandidate[]
    - `candidate_id` string
    - `cycle` integer
    - `total` 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)