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

# Data Exports

> Export your billing data for analysis and compliance

# Data Exports

Export your Alguna data for analysis, compliance, accounting, and backup purposes.

***

## Available Exports

| Export Type       | Contains                            | Formats         |
| ----------------- | ----------------------------------- | --------------- |
| **Invoices**      | All invoice data with line items    | CSV, PDF (bulk) |
| **Customers**     | Account information and contacts    | CSV             |
| **Subscriptions** | Active and historical subscriptions | CSV             |
| **Payments**      | Payment transactions and status     | CSV             |
| **Revenue**       | Revenue recognition schedules       | CSV             |
| **Usage**         | Usage events and aggregations       | CSV             |
| **Credits**       | Credit grants and consumption       | CSV             |

***

## Exporting Data

### Via Dashboard

1. Navigate to **Settings → Data Exports**
2. Select export type
3. Set date range and filters
4. Choose format (CSV or PDF for invoices)
5. Click **Export**
6. Download when ready

### Export Filters

| Filter         | Description                                 |
| -------------- | ------------------------------------------- |
| **Date Range** | Start and end date for the export           |
| **Status**     | Filter by status (e.g., paid invoices only) |
| **Customer**   | Export for specific customers               |
| **Product**    | Filter by product or plan                   |

***

## Export Formats

### CSV

Standard CSV format with headers. Can be opened in Excel, Google Sheets, or imported into other systems.

**Invoice CSV Example:**

| invoice\_id | account\_name | status | total  | currency | issued\_at | paid\_at   |
| ----------- | ------------- | ------ | ------ | -------- | ---------- | ---------- |
| INV-001     | Acme Corp     | paid   | 99.00  | USD      | 2024-01-01 | 2024-01-05 |
| INV-002     | Globex Inc    | paid   | 199.00 | USD      | 2024-01-01 | 2024-01-03 |

### PDF (Invoices Only)

Export invoices as a ZIP file containing individual PDFs:

1. Navigate to **Settings → Data Exports**
2. Select **Invoices**
3. Choose format: **PDF**
4. Set date range
5. Click **Export**
6. Download ZIP file with all invoice PDFs

***

## Export Types

### Invoices Export

| Field         | Description               |
| ------------- | ------------------------- |
| invoice\_id   | Unique invoice identifier |
| account\_id   | Customer account ID       |
| account\_name | Customer name             |
| status        | paid, issued, draft, void |
| subtotal      | Amount before tax         |
| tax           | Tax amount                |
| total         | Total amount              |
| currency      | Invoice currency          |
| issued\_at    | Date invoice was issued   |
| due\_date     | Payment due date          |
| paid\_at      | Date payment received     |

### Customers Export

| Field                | Description               |
| -------------------- | ------------------------- |
| account\_id          | Unique account identifier |
| name                 | Company or customer name  |
| email                | Billing email             |
| currency             | Customer's currency       |
| country              | Billing country           |
| subscription\_status | active, canceled, none    |
| mrr                  | Monthly recurring revenue |
| created\_at          | Account creation date     |

### Subscriptions Export

| Field            | Description                           |
| ---------------- | ------------------------------------- |
| subscription\_id | Unique subscription ID                |
| account\_id      | Customer account ID                   |
| account\_name    | Customer name                         |
| plan\_name       | Plan name                             |
| status           | active, canceled, paused              |
| mrr              | Monthly recurring revenue             |
| start\_date      | Subscription start date               |
| end\_date        | Subscription end date (if applicable) |

### Revenue Export

| Field              | Description                  |
| ------------------ | ---------------------------- |
| period             | Recognition period (YYYY-MM) |
| subscription\_id   | Subscription ID              |
| account\_name      | Customer name                |
| product\_name      | Product name                 |
| recognized\_amount | Amount recognized            |
| deferred\_amount   | Amount still deferred        |
| currency           | Currency                     |

### Usage Export

| Field         | Description          |
| ------------- | -------------------- |
| account\_id   | Customer account ID  |
| account\_name | Customer name        |
| metric\_code  | Billable metric code |
| period        | Billing period       |
| usage\_value  | Total usage          |
| cost          | Calculated cost      |
| currency      | Currency             |

### Credits Export

| Field         | Description         |
| ------------- | ------------------- |
| account\_id   | Customer account ID |
| account\_name | Customer name       |
| grant\_id     | Credit grant ID     |
| type          | monetary or units   |
| amount        | Credit amount       |
| remaining     | Remaining balance   |
| expires\_at   | Expiration date     |

***

## Compliance Exports

### Audit Trail

Export all changes for compliance purposes:

1. Navigate to **Settings → Data Exports**
2. Select **Audit Trail**
3. Set date range
4. Choose entity types (invoices, subscriptions, etc.)
5. Export

### GDPR Data Export

Export all data for a specific customer (data subject request):

1. Navigate to **Customers → \[Customer]**
2. Click **Export All Data**
3. Download complete customer data package

***

## Using Exported Data

### Excel / Google Sheets

1. Download CSV export
2. Open in Excel or import to Google Sheets
3. Use pivot tables for analysis

### Accounting Systems

1. Export invoices or revenue data
2. Import into QuickBooks, Xero, or your accounting system
3. Match to your chart of accounts

### Data Warehouse

1. Export data via API (see API Reference)
2. Load into your data warehouse
3. Use for business intelligence

***

## Best Practices

<CardGroup cols={2}>
  <Card title="Regular Backups" icon="cloud-arrow-down">
    Export data periodically for backup purposes.
  </Card>

  <Card title="Use Filters" icon="filter">
    Export only what you need to keep file sizes manageable.
  </Card>

  <Card title="Secure Storage" icon="lock">
    Store exports securely—they contain billing data.
  </Card>

  <Card title="Audit Retention" icon="file-lines">
    Keep audit exports for compliance requirements.
  </Card>
</CardGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Accounting Integration" icon="calculator" href="/integrations/accounting/quickbooks">
    Sync data automatically instead of exporting.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/overview">
    Export data programmatically via API.
  </Card>
</CardGroup>