---
title: "GET /v1/calendar-dates/export/"
method: GET
path: "/v1/calendar-dates/export/"
tags: ["dates"]
---

# GET /v1/calendar-dates/export/

`GET /v1/calendar-dates/export/`

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

Returns CSV or ICS for downloading directly into calendar applications like Google, Outlook or other applications.

Combines the election and reporting dates with Commission meetings, conferences, outreach, Advisory Opinions, rules, litigation dates and other
events into one calendar.

State filtering now applies to elections, reports and reporting periods.

Presidential pre-primary report due dates are not shown on even years.
Filers generally opt to file monthly rather than submit over 50 pre-primary election
reports. All reporting deadlines are available at /reporting-dates/ for reference.

This is [the sql function](https://github.com/fecgov/openFEC/blob/develop/data/migrations/V40__omnibus_dates.sql)
that creates the calendar.

## Query parameters

- `renderer` 'ics' | 'csv'
- `page` integer
- `per_page` integer
- `calendar_category_id` integer[]
- `description` string[]
- `summary` string[]
- `min_start_date` string
- `min_end_date` string
- `max_start_date` string
- `max_end_date` string
- `event_id` integer
- `sort` string
- `sort_hide_null` boolean
- `sort_null_only` boolean
- `sort_nulls_last` boolean
- `api_key` string

## Response `default`

Default response

- CalendarDatePage
  - `pagination` OffsetInfo
    - `count` integer
    - `is_count_exact` boolean
    - `page` integer
    - `pages` integer
    - `per_page` integer
  - `results` CalendarDate[]
    - `all_day` boolean, nullable
    - `calendar_category_id` integer, nullable: Each type of event has a calendar category with an integer id. Options are: Open Meetings: 32, Executive Sessions: 39, Public Hearings: 40, Conferences: 33, Roundtables: 34, Election Dates: 36, Federal Holidays: 37, FEA Periods: 38, Commission Meetings: 20, Reporting Deadlines: 21, Conferences and Outreach: 22, AOs and Rules: 23, Other: 24, Quarterly: 25, Monthly: 26, Pre and Post-Elections: 27, EC Periods:28, and IE Periods: 29
    - `category` string, nullable: Each type of event has a calendar category with an integer id. Options are: Open Meetings: 32, Executive Sessions: 39, Public Hearings: 40, Conferences: 33, Roundtables: 34, Election Dates: 36, Federal Holidays: 37, FEA Periods: 38, Commission Meetings: 20, Reporting Deadlines: 21, Conferences and Outreach: 22, AOs and Rules: 23, Other: 24, Quarterly: 25, Monthly: 26, Pre and Post-Elections: 27, EC Periods:28, and IE Periods: 29
    - `description` string
    - `end_date` unknown
    - `event_id` integer: An unique ID for an event. Useful for downloading a single event to your calendar. This ID is not a permanent, persistent ID.
    - `location` string, nullable: Can be state address or room.
    - `start_date` unknown
    - `state` string[], nullable: The state field only applies to election dates and reporting deadlines, reporting periods and all other dates do not have the array of states to filter on
    - `summary` string
    - `url` string, nullable: A url for that event

---

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