## Data Export Documentation

The m3ter _Data Export_ service allows you to export usage data and operational data from your m3ter Organization directly into your AWS S3 or Google Cloud Storage buckets:

- **Export Destinations**: Create Export Destinations and enable the Data Export service to export data to your AWS S3 or Google Cloud Storage buckets.
- **Export Schedules**: Use the Export Destinations you’ve set up to configure Export Schedules for usage or operational data exports at specified intervals of minutes, hours, or days.
- **Ad-Hoc Exports**: Select an Export Destination to run a one-off, ad-hoc, data export, delivered either to an existing Export Destination or local device.

### Configurable Data Sets
When setting up Export Schedules or running ad-hoc exports, you can define the data to include in the exported data set:

- **Usage Data**: Define the usage data measurements ingested for your Organization by Meter and Account.
- **Operational Data**: Export configuration and operational data for various entities from your production environment, such as Bills, Bill Line Items, Prepayments, Accounts, and Balances.
- **Export Format**: Available formats for data exports: `.CSV` or `JSONL`.

Export jobs are created for both schedules and ad-hoc exports, and you can review their status at any time. To download the content of a data export file locally, omit a destination when setting up an Export. A download button will be provided on the Export jobs page once the job has successfully run.

This service supports various business use cases by allowing you to export defined usage or operational data sets from your m3ter Organization for other applications like dashboards or reporting tools.

### Data Export Management
This section explains how to create and manage Data Exports:

- [Creating and Managing Export Destinations](https://docs.m3ter.com/guides/data-exports/creating-data-export-destinations)
- [Creating Usage Data Export Schedules](https://docs.m3ter.com/guides/data-exports/creating-export-schedules)
- [Creating Operational Data Export Schedules](https://docs.m3ter.com/guides/data-exports/creating-operational-data-export-schedules)
- [Reviewing and Managing Export Schedules](https://docs.m3ter.com/guides/data-exports/reviewing-and-managing-export-schedules)
- [Running Ad-Hoc Usage Data Exports](https://docs.m3ter.com/guides/data-exports/running-ad-hoc-data-exports)
- [Running Ad-Hoc Operational Data Exports](https://docs.m3ter.com/guides/data-exports/running-ad-hoc-operational-data-exports)
- [Downloading Data Export Files Locally](https://docs.m3ter.com/guides/data-exports/downloading-data-export-files-locally)
- [Reviewing Export Jobs](https://docs.m3ter.com/guides/data-exports/reviewing-export-jobs)
- [Data Export - Entity Schema and Relationship Diagram](https://docs.m3ter.com/guides/data-exports/data-export-object-relationship-diagram)

### Important: Permissions for Data Export
For users to create, manage, and run Data Exports, the following permissions should be assigned:

- **Create and Manage Exports**: Create and Update actions for `config:exportDestination`, `config:exportSchedules`, and `config:exportStatus`.
- **Run Exports**: Download export actions for `exports:data`.

Be cautious not to grant permissions to users who shouldn’t have access to all data in m3ter. See [Understanding, Creating, and Managing Permission Policies](https://docs.m3ter.com/guides/organization-and-access-management/creating-and-managing-permissions).
