Data Export

# Export all valuations from the last 30 days
curl -X POST https://api.justkalm.com/v2/export/valuations \
  -H "Authorization: Bearer jk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "json",
    "date_from": "2024-01-01",
    "date_to": "2024-01-31",
    "include_metadata": true
  }'

# Response: Export job created
{
  "export_id": "exp_K7j9mNpQ",
  "status": "processing",
  "estimated_time": "2 minutes",
  "download_url": null
}

# Poll for export completion
curl https://api.justkalm.com/v2/export/exp_K7j9mNpQ \
  -H "Authorization: Bearer jk_live_xxx"

# Response when complete
{
  "export_id": "exp_K7j9mNpQ",
  "status": "complete",
  "format": "json",
  "file_size": "15.2 MB",
  "record_count": 45230,
  "download_url": "https://exports.justkalm.com/exp_K7j9mNpQ.json.gz",
  "expires_at": "2024-02-01T00:00:00Z"
}

import { JustKalm } from '@justkalm/sdk';

const client = new JustKalm({ apiKey: 'jk_live_xxx' });

// Create and download export
const exp = await client.exports.create({
  type: 'valuations',
  format: 'csv',
  dateFrom: new Date('2024-01-01'),
  dateTo: new Date('2024-01-31'),
});

// Wait for completion (with built-in polling)
const completed = await exp.waitForCompletion();

// Download to file
await completed.downloadTo('./valuations-jan-2024.csv');

console.log(`Downloaded ${completed.recordCount} records`);

# Request full account data export (GDPR Article 20)
curl -X POST https://api.justkalm.com/v2/account/export \
  -H "Authorization: Bearer jk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "full_account",
    "format": "json",
    "include": [
      "valuations",
      "api_keys",
      "webhooks",
      "team_members",
      "billing_history",
      "usage_logs"
    ]
  }'

# Response
{
  "export_id": "exp_gdpr_L8k0nOrR",
  "status": "processing",
  "estimated_time": "10 minutes",
  "notification_email": "you@example.com"
}