Exporting Your Data

A hosted account can download a copy of its own data from the console at any time — no support request, no waiting period, and no charge. This page describes what the export contains and the limits that apply to it.

Hosted accounts only

Export is a feature of the hosted tier. A self-hosted License Server stores everything in your own database, which you can back up or query directly, so there is no separate export.

Downloading the export

1. Sign in to the console and open Settings.
2. Under Export your data, click Download my data.

Your browser downloads a file named casazium-data-export-YYYY-MM-DD.json (the date is in UTC). There's no confirmation step and no password prompt: the export contains the same data you can already see in the console. The file is generated fresh each time you click, so it reflects your account at that moment.

If you're about to delete your account, download the export first. Deletion is immediate and permanent, and the data can't be recovered afterward.

What's in the file

The export is a single JSON object, formatted for reading:

{
  "exported_at": "2026-09-13T18:30:00.000Z",
  "account": {
    "email": "you@example.com",
    "tenant_name": "Example Software",
    "tenant_id": "tenant-id"
  },
  "billing": {
    "status": "active",
    "plan": "pro",
    "cancelAtPeriodEnd": false,
    "currentPeriodEnd": null,
    "licensesUsed": 12,
    "licenseLimit": 100
  },
  "licenses": [
    {
      "key": "7yChyZcfMG23Dx1sjBoLziPFrH4n-6f28",
      "product_id": "my-product",
      "tier": "pro",
      "status": "active",
      "issued_to": "customer@example.com",
      "issued_at": "2026-01-01T00:00:00.000Z",
      "expires_at": "2027-12-31T23:59:59.000Z",
      "limits": {},
      "usage": {},
      "max_activations": 5,
      "revoked_at": null,
      "activations": [
        {
          "instance_id": "unique-instance-id",
          "activated_at": "2026-01-02T00:00:00.000Z"
        }
      ]
    }
  ]
}

The values above are examples. All timestamps are ISO 8601, in UTC.

Top level

Field	Description
exported_at	When the file was generated.
account	The account the export belongs to (below).
billing	The account's plan and subscription status (below).
licenses	Every license the account owns, newest first (below).

account

Field	Description
email	The console sign-in email address.
tenant_name	The organization name given at signup.
tenant_id	The account's internal identifier on the License Server.

billing

The same object GET /v1/billing/status returns.

Field	Description
status	active, past_due, or canceled.
plan	The paid plan, or null for an account on the Free plan with no billing history.
cancelAtPeriodEnd	true if a paid subscription has been canceled but hasn't ended yet.
currentPeriodEnd	When that cancellation takes effect, or null.
licensesUsed	Active licenses counted against the plan's quota.
licenseLimit	The plan's limit on active licenses.

Each entry in licenses

Every license the account has issued, including revoked and expired ones.

Field	Description
key	The license key.
product_id	The product the license is for.
tier	The license's tier name.
status	active or revoked. An expired license can still show active; compare expires_at.
issued_to	Who the license was issued to, as entered when it was issued.
issued_at	When the license was issued.
expires_at	When the license expires, or null for a perpetual license.
limits	The license's usage limits, e.g. {"seats": 10}. Empty if none were set.
usage	Usage tracked against those limits. Empty if none has been recorded.
max_activations	How many instances may activate the license, or null for unlimited.
revoked_at	When the license was revoked, or null.
activations	The license's current activations: each has an instance_id and activated_at. Empty if none.

What isn't in the file

• License notes. The free-text notes you can add on a license's detail page aren't included.
• Your password and API key. Neither is exported.
• Payment details. Card and payment records are held by Stripe, not by Casazium; manage or download them through the billing portal linked from the console's billing page.

Limits

• Up to 1,000 licenses per export. Licenses are exported newest first. If your account has more than 1,000, the file contains the 1,000 most recently issued, and nothing in the file says it was cut short. If that applies to you, contact us for a complete export.
• One export per minute. Clicking again within a minute shows "Please wait a minute before requesting another export."
• It counts toward your API rate limit. Building the file makes one request to the License Server for the license list, one for billing status, and one per license for its activations. Those requests share the admin reporting rate limit with everything else your account does. If an export would exceed it, the console shows "Too many requests to the license server. Try again shortly."

Handling the file

The export contains your license keys, which work as credentials, and the names or email addresses you entered for your own customers in issued_to. Store it as carefully as you would the account itself.