---
title: "GET /v1/communication_costs/"
method: GET
path: "/v1/communication_costs/"
tags: ["communication cost"]
---

# GET /v1/communication_costs/

`GET /v1/communication_costs/`

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

52 U.S.C. 30118 allows "communications by a corporation to its stockholders and executive or administrative personnel and their families or by a labor organization to its members and their families on any subject," including the express advocacy of the election or defeat of any Federal candidate.  The costs of such communications must be reported to the Federal Election Commission under certain circumstances.

## Query parameters

- `page` integer
- `per_page` integer
- `image_number` string[]
- `min_image_number` string
- `max_image_number` string
- `min_amount` number
- `max_amount` number
- `min_date` string
- `max_date` string
- `committee_id` string[]
- `candidate_id` string[]
- `support_oppose_indicator` string[]
- `sort` string
- `sort_hide_null` boolean
- `sort_null_only` boolean
- `sort_nulls_last` boolean
- `api_key` string

## Response `default`

Default response

- CommunicationCostPage
  - `pagination` OffsetInfo
    - `count` integer
    - `is_count_exact` boolean
    - `page` integer
    - `pages` integer
    - `per_page` integer
  - `results` CommunicationCost[]
    - `action_code` string, nullable
    - `action_code_full` string, nullable
    - `candidate_first_name` string, nullable
    - `candidate_id` string, nullable
    - `candidate_last_name` string, nullable
    - `candidate_middle_name` string, nullable
    - `candidate_name` string, nullable
    - `candidate_office` string, nullable
    - `candidate_office_district` string, nullable
    - `candidate_office_full` string, nullable
    - `candidate_office_state` string, nullable
    - `committee_id` string, nullable
    - `committee_name` string, nullable
    - `communication_class` string, nullable
    - `communication_type` string, nullable
    - `communication_type_full` string, nullable
    - `cycle` integer, nullable
    - `file_number` integer, nullable
    - `form_type_code` string, nullable
    - `image_number` string, nullable
    - `original_sub_id` integer, nullable
    - `pdf_url` string, nullable
    - `primary_general_indicator` string, nullable
    - `primary_general_indicator_description` string, nullable
    - `purpose` string, nullable
    - `report_type` string, nullable
    - `report_year` integer, nullable
    - `schedule_type` string, nullable
    - `schedule_type_full` string, nullable
    - `state_full` string, nullable
    - `sub_id` integer
    - `support_oppose_indicator` string, nullable
    - `tran_id` string, nullable
    - `transaction_amount` number
    - `transaction_date` string, date, nullable
    - `transaction_type` string, nullable

---

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