---
title: "Email data as a Zip file of CSVs"
method: POST
path: "/api/data/email/"
tags: ["Utilities & Data"]
---

# Email data as a Zip file of CSVs

`POST /api/data/email/`

Schedules an email to be sent to the authenticated user containing question data, forecast data, and optionally comments, scores, and key factors as a Zip file of CSVs.
Useful for large data exports that may time out with a direct download. Accepts the same parameters as `/api/data/download/`.
You must provide at least one of `post_id`, `question_id`, or `project_id`.

**Note:** This is a restricted endpoint. To request access, please fill out the [Metaculus Data Needs Form](https://docs.google.com/forms/d/e/1FAIpQLSeJhtZzHl5qMvBjbXbatyaqoS4IU7RE0GGw_vlhs6I9syqn1g/viewform?usp=pp_url&entry.192763438=https://www.metaculus.com/api/). For questions or feedback, contact [api-requests@metaculus.com](mailto:api-requests@metaculus.com). Additionally, the `project_id` parameter is only accepted if your account has been whitelisted for that specific project.

The email attachment has a size limit of 25 MB. If your export exceeds this limit, try removing `include_comments` to reduce the file size.

## Request body

- object
  - `post_id` integer — The ID of the post to export data for.
  - `question_id` integer — The ID of the question to export data for.
  - `project_id` integer — The ID of the project to export data for.
  - `sub_question` integer — If the post contains a group or conditional question, specify a sub-question ID.
  - `aggregation_methods` string[] — List of aggregation methods to include. Valid methods: `recency_weighted`, `unweighted`, `metaculus_prediction`, `single_aggregation`.
  - `minimize` boolean — If false, includes all data points in recalculated aggregations.
  - `include_bots` boolean — Whether to include bot forecasts in aggregation recalculations.
  - `user_ids` integer[] — A list of user IDs to restrict aggregation recalculations to. Only available to staff and whitelisted users.
  - `include_comments` boolean — If true, includes comment data.
  - `include_scores` boolean — If true, includes score data.
  - `include_key_factors` boolean — If true, includes key factors data.

## Response `200`

Email scheduled successfully

- object
  - `message` string

---

[API](https://skmtc.dev/metaculus/apis/metaculus-api.md) · [All operations](https://skmtc.dev/metaculus/apis/metaculus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/metaculus/metaculus-api/revisions/f1b9a08e1da2/schema)