> ## Documentation Index
> Fetch the complete documentation index at: https://docs.m3ter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reviewing Export Jobs

*Export jobs* are created each time a usage or operational data export is due to run under an Export schedule or when you run an ad-hoc data export. You can review and check the status of Export jobs at any time, which are listed on the Export jobs page:

* Read-off job status:
  * Pending
  * Running
  * Succeeded
  * Failed
* Filter the list by job status.
* Filter the list by specifying a date range by job start date.
* Download data export files locally.

This topic explains how to review Export jobs for your data exports, check their status, download data export files locally, and follow-up on failed jobs:

* [Reviewing Export Jobs and Checking Status](/guides/data-exports/reviewing-export-jobs#reviewing-export-jobs-and-checking-status)
* [Downloading Data Export Files](/guides/data-exports/reviewing-export-jobs#downloading-data-export-files)
* [Following-Up on Failed Export Jobs](/guides/data-exports/reviewing-export-jobs#following-up-on-failed-export-jobs)

## Reviewing Export Jobs and Checking Status

**To review Export jobs and check their status:**

1. Select **Data exports**:

<img src="https://mintcdn.com/m3ter/FcWrVREdED1szRzf/images/1758545636-dataexport46c.png?fit=max&auto=format&n=FcWrVREdED1szRzf&q=85&s=a59e5ef18b94efe971f15285e5f7d7bc" style={{ maxWidth: 'min(160px, 100%)' }} width="223" height="178" data-path="images/1758545636-dataexport46c.png" />

The **Data exports** page opens.

2. In the sidebar, select **Export jobs**:

<img src="https://mintcdn.com/m3ter/03osooeLKFU5Y0yI/images/1732629371-dataexport47.png?fit=max&auto=format&n=03osooeLKFU5Y0yI&q=85&s=3cf8f4d31f2ffb7f18216fe1be3efbaa" style={{ maxWidth: 'min(175px, 100%)' }} width="314" height="127" data-path="images/1732629371-dataexport47.png" />

The **Export jobs** page opens and lists all the jobs created for your Export schedules and ad-hoc data exports:

<img src="https://mintcdn.com/m3ter/UNNNqzWAlbEgfOnu/images/DataExport97.png?fit=max&auto=format&n=UNNNqzWAlbEgfOnu&q=85&s=7a541c118fab1744747dce600dd2336e" alt="Data Export97" width="1150" height="297" data-path="images/DataExport97.png" />

* For each Export job listed, you can read-off:
  * The **Start date** and time the export was scheduled to run.
  * The Export job **ID**, which you can **Copy** directly to your clipboard.
  * The **Source type** for the Export job.
  * Under **Schedule**, whether the job was created for an Export schedule or for an ad-hoc export.
  * The job **Status**.
* You can open the **Details** page for an Export schedule using the **Schedule** hotlink text.

<Tip>
  **Notes:**

  **Schedule not showing?** If you delete an Export Schedule after an Export job has been run for the schedule, then **(Schedule not found)** will show under **Schedule**.

  * **Follow-up on Failed Export jobs?** You can make an API call to retrieve details of failed Export jobs - see the [section below](/guides/data-exports/reviewing-export-jobs#following-up-on-failed-export-jobs) for how to do this.
</Tip>

3. Export jobs with any **Status** are listed by default when the page opens. If you want to filter the list, use the **Status** drop-down:

<img src="https://mintcdn.com/m3ter/r3D0c1hhAuooaNQf/images/1728307852-dataexport26.png?fit=max&auto=format&n=r3D0c1hhAuooaNQf&q=85&s=fcdec623ca1b148774e2c4cb957d55cc" style={{ maxWidth: 'min(450px, 100%)' }} width="618" height="222" data-path="images/1728307852-dataexport26.png" />

The page adjusts to show only those Export jobs with the selected **Status**.

3. Export jobs for any **Start date** are listed by default when the page opens, and ordered by timestamp with most recent job first. Use the **Start date** popup calendars to define a date range to filter the list to show only those Export jobs with a start date within the date range.

## Downloading Data Export Files

On the **Export jobs** page, an *active download button* will be available for downloading the export file locally for an Export job that has succeeded for an Export schedule or ad-hoc Export *within the past 24 hours*.

To download the data export file locally, simply select the active download button:

<Frame>
  <img src="https://mintcdn.com/m3ter/UNNNqzWAlbEgfOnu/images/DataExport96.png?fit=max&auto=format&n=UNNNqzWAlbEgfOnu&q=85&s=e96d13725aafc5312083b5a8cca66074" alt="Data Export96" width="1149" height="250" data-path="images/DataExport96.png" />
</Frame>

<Tip>
  **Tip: More Details?** See [Downloading Data Export Files Locally](/guides/data-exports/downloading-data-export-files-locally).
</Tip>

## Following-Up on Failed Export Jobs

You can use the [List EventResponse](/api/events/list-eventresponse) API call to query for any events of type `dataexport.job.failure`.

For example:

`GET https://api.m3ter.com/organizations/{orgId}/events?eventName=dataexport.job.failure`

The response gives details of the Export job failure event:

```json theme={null}
{
    "data": [
        {
            "id": "3bffe288-f04e-4a6f-8d0b-39c616faxyxy",
            "eventName": "dataexport.job.failure",
            "eventTime": "2024-10-28T10:02:23.892Z",
            "m3terEvent": {
                "eventData": {
                    "jobId": "dc83dec1-94af-4611-b532-fd778b83xy99",
                    "code": "NoSuchBucket",
                    "sourceType": "USAGE",
                    "startedAt": "2024-10-28T10:02:23.614Z",
                    "eventType": "DataExportJobFailure",
                    "orgId": "eb4d6f1e-0795-484e-a0b8-3640ca22xyxy",
                    "scheduleId": "ed1f2303-87b3-4b43-bc27-0b6d70axyx0xa"
                },
                "eventTime": "2024-10-28T10:02:23.892Z",
                "eventName": "dataexport.job.failure"
            }
        },
...
]
```