Developer guide

Data export

Download your account, requests, usage, and transactions.

Everything we store for your account can be downloaded at any time, as one zip file with five files.

  1. Open the console and click your name at the bottom of the sidebar.
  2. Choose Settings, then Privacy.
  3. Under Data export, click Export data. The zip downloads right away.

You can also ask for an export by email to support@uprelic.com from the address of your account. All times in the files are ISO 8601 in UTC; amounts are decimal strings with full precision, in the currency named next to them.

File Format Contents
account.json JSON format_version, exported_at; account: id, email, created and closed dates, currency, balance; api_keys: id, name, key prefix and creation date of each key. Key secrets are never stored, so never exported.
requests.json JSON A list of the requests whose content is still stored (content is deleted after your plan's retention period, 7 days on Free, or earlier on request): id, time, source (api or playground), API key name, model, and the request and response exactly as stored. Image URLs are kept; images sent as data: URLs are stored without their data.
usage.csv CSV One row per request, also after its content is deleted: request_id, created_at, source, api_key, model, questions, images, input_tokens, output_tokens, cost, currency, cost_usd, fx_rate, content_stored (yes or no).
transactions.csv CSV One row per change to your balance other than requests: transaction_id, created_at, kind (topup, grant or adjustment), amount, currency, stripe_checkout_session_id (top-ups through Checkout), stripe_invoice_id (automatic top-ups), note. Invoices are in the Stripe customer portal, linked from Billing.
notifications.json JSON A list of the notifications we sent you in the last 12 months, such as low-balance emails: id, time, kind (e.g. low_balance), channel (email), recipient, the message as sent (subject, body as plain text, html), status (sent, failed or pending) and sent_at.

CSV files use commas, double quotes where needed and UTF-8, with a header row. If the format changes, format_version in account.json changes with it.