Skip to main content

Data Exports

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

Available Exports

Export TypeContainsFormats
InvoicesAll invoice data with line itemsCSV, PDF (bulk)
CustomersAccount information and contactsCSV
SubscriptionsActive and historical subscriptionsCSV
PaymentsPayment transactions and statusCSV
RevenueRevenue recognition schedulesCSV
UsageUsage events and aggregationsCSV
CreditsCredit grants and consumptionCSV

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

FilterDescription
Date RangeStart and end date for the export
StatusFilter by status (e.g., paid invoices only)
CustomerExport for specific customers
ProductFilter 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_idaccount_namestatustotalcurrencyissued_atpaid_at
INV-001Acme Corppaid99.00USD2024-01-012024-01-05
INV-002Globex Incpaid199.00USD2024-01-012024-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

FieldDescription
invoice_idUnique invoice identifier
account_idCustomer account ID
account_nameCustomer name
statuspaid, issued, draft, void
subtotalAmount before tax
taxTax amount
totalTotal amount
currencyInvoice currency
issued_atDate invoice was issued
due_datePayment due date
paid_atDate payment received

Customers Export

FieldDescription
account_idUnique account identifier
nameCompany or customer name
emailBilling email
currencyCustomer’s currency
countryBilling country
subscription_statusactive, canceled, none
mrrMonthly recurring revenue
created_atAccount creation date

Subscriptions Export

FieldDescription
subscription_idUnique subscription ID
account_idCustomer account ID
account_nameCustomer name
plan_namePlan name
statusactive, canceled, paused
mrrMonthly recurring revenue
start_dateSubscription start date
end_dateSubscription end date (if applicable)

Revenue Export

FieldDescription
periodRecognition period (YYYY-MM)
subscription_idSubscription ID
account_nameCustomer name
product_nameProduct name
recognized_amountAmount recognized
deferred_amountAmount still deferred
currencyCurrency

Usage Export

FieldDescription
account_idCustomer account ID
account_nameCustomer name
metric_codeBillable metric code
periodBilling period
usage_valueTotal usage
costCalculated cost
currencyCurrency

Credits Export

FieldDescription
account_idCustomer account ID
account_nameCustomer name
grant_idCredit grant ID
typemonetary or units
amountCredit amount
remainingRemaining balance
expires_atExpiration 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

Regular Backups

Export data periodically for backup purposes.

Use Filters

Export only what you need to keep file sizes manageable.

Secure Storage

Store exports securely—they contain billing data.

Audit Retention

Keep audit exports for compliance requirements.

Next Steps