Data Exports

curl "https://api.alguna.io/invoices?limit=100&offset=0&sort=issue_date:desc&status=paid&paid_date_gte=2026-01-01" \
  -H "Authorization: Bearer $ALGUNA_API_KEY" \
  -H "Alguna-Version: 2026-04-01"

import csv
import os

import requests

headers = {
    "Authorization": f"Bearer {os.environ['ALGUNA_API_KEY']}",
    "Alguna-Version": "2026-04-01",
}

rows = []
offset = 0
while True:
    response = requests.get(
        "https://api.alguna.io/invoices",
        headers=headers,
        params={
            "limit": 100,
            "offset": offset,
            "sort": "issue_date:desc",
            "status": "paid",
            "paid_date_gte": "2026-01-01",
        },
        timeout=10,
    )
    response.raise_for_status()
    page = response.json()["data"]
    rows.extend(page)
    if len(page) < 100:
        break
    offset += 100

with open("paid_invoices.csv", "w", newline="") as f:
    writer = csv.DictWriter(
        f, fieldnames=["id", "external_reference", "customer_id", "currency", "total", "status", "paid_date"]
    )
    writer.writeheader()
    for invoice in rows:
        writer.writerow({k: invoice.get(k) for k in writer.fieldnames})

const page = await alguna.invoices.list({
  limit: 100,
  offset: 0,
  sort: "issue_date:desc",
  status: ["paid"],
  paid_date_gte: "2026-01-01",
});