Export & evidence

Everything your tenant ever recorded, streamed back to you as newline-delimited JSON. One endpoint, one bearer key, no negotiation. The export exists so that leaving Empress — or proving something to an auditor — never depends on us.

How it works

GET /export streams your tenant’s whole ledger as cursor-paged NDJSON. Authenticate with your API key; the key scopes the query to your tenant at the SQL level, so the export physically cannot contain another tenant’s statements — the same machine-verified isolation that governs every read.

curl "https://empress-api.jdnyzio.workers.dev/export" \
  -H "Authorization: Bearer YOUR_API_KEY" > ledger.ndjson

Large ledgers page through a cursor: each response tells you where to resume, and you follow it until the stream is exhausted. The result is a complete, ordered copy of your data.

What the file looks like

One xAPI statement per line, each line a complete JSON document. NDJSON is deliberately boring: it greps, it streams, it loads into any warehouse or script without a parser someone has to maintain.

{"actor":{"account":{"name":"agent-7","homePage":"https://empress.eco"}},"verb":{"id":"https://empress.eco/verbs/completed"},"object":{"id":"https://your-app.example/tasks/42"}}
{"actor":{"account":{"name":"agent-7","homePage":"https://empress.eco"}},"verb":{"id":"http://adlnet.gov/expapi/verbs/scored"},"object":{"id":"https://your-app.example/tasks/43"}}

Audits and compliance evidence

Because the ledger is immutable — statements are never rewritten or deleted — an export is a faithful reproduction of what was recorded, when it was recorded. That makes it useful raw material for evidence workflows: answering a GDPR access request about what behavioral data you hold on an actor, or assembling the record-keeping and traceability documentation that EU AI Act workflows call for. You run the export, you hold the file, your auditors read it on your terms.

To be explicit: Empress holds no certifications today — no SOC 2, no ISO, no formal attestation. What we offer is the property that matters underneath all of those: a complete, immutable, exportable record. The certifications are the paperwork; the export is the substance.

No lock-in, structurally

A vendor promise of “you can always leave” is only as good as the tooling that backs it. Here the tooling is a single GET request available on every tier. Your data arrives in an open format defined by the xAPI specification, not by us — any conformant learning record store, warehouse, or script can consume it. If Empress stops earning your business, the exit costs one curl command.

---

Next: Concepts · API reference · Quickstart