---
title: "Export archived issue(s)"
method: PUT
path: "/rest/api/3/issues/archive/export"
tags: ["Issues"]
---

# Export archived issue(s)

`PUT /rest/api/3/issues/archive/export`

Enables admins to retrieve details of all archived issues. Upon a successful request, the admin who submitted it will receive an email with a link to download a CSV file with the issue details.

Note that this API only exports the values of system fields and archival-specific fields (`ArchivedBy` and `ArchivedDate`). Custom fields aren't supported.

**[Permissions](#permissions) required:** Jira admin or site admin: [global permission](https://confluence.atlassian.com/x/x4dKLg)

**License required:** Premium or Enterprise

**Signed-in users only:** This API can't be accessed anonymously.

**Rate limiting:** Only a single request can be active at any given time.

## Request body

- ArchivedIssuesFilterRequest — Details of a filter for exporting archived issues.
  - `archivedBy` string[] — List archived issues archived by a specified account ID.
  - `archivedDateRange` DateRangeFilterRequest — List issues archived within a specified date range.
    - `dateAfter` string, required — List issues archived after a specified date, passed in the YYYY-MM-DD format.
    - `dateBefore` string, required — List issues archived before a specified date provided in the YYYY-MM-DD format.
  - `issueTypes` string[] — List archived issues with a specified issue type ID.
  - `projects` string[] — List archived issues with a specified project key.
  - `reporters` string[] — List archived issues where the reporter is a specified account ID.

## Response `202`

Returns the details of your export task. You can use the [get task](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-tasks/#api-rest-api-3-task-taskid-get) API to view the progress of your request.

- ExportArchivedIssuesTaskProgressResponse — The response for status request for a running/completed export task.
  - `fileUrl` string
  - `payload` string
  - `progress` integer
  - `status` string
  - `submittedTime` string, date-time
  - `taskId` string

## Other responses

- `400` — Returned when: * The request is invalid, or the filters provided are incorrect * You requested too many issues for export. The limit is one million issues per request
- `401` — Returned if no issues were unarchived because the provided authentication credentials are either missing or invalid.
- `403` — Returned if no issues were unarchived because the user lacks the required Jira admin or site admin permissions.
- `412` — Returned if a request to export archived issues is already running.

---

[API](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3.md) · [All operations](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-3/revisions/2783f5d3849c/schema)