html.surf
Sign in
Docs /Downloads API Dashboard →

Downloads API

Export download session data as CSV for reporting and reconciliation.

Download Sessions Report

Returns a CSV of download sessions in a date range. Each row joins the session to its product and the originating purchase's customer, so you can see who downloaded what and when. Filter is by session start time, so a January report returns sessions that started in January — completions outside the window still show their actual completedAt in the row.

GET /api/reports/downloads

Query Parameters

  • from — start date (YYYY-MM-DD). Defaults to the epoch.
  • to — end date (YYYY-MM-DD), inclusive. Defaults to far future.
  • productId — optional, filter to one product
  • status — optional, filter sessions by status (e.g. completed, failed)
  • limit — optional, cap the number of rows returned

Response

CSV. The endpoint is admin-only — calls from member-role keys return 403.

curl "https://continuata.io/api/reports/downloads?from=2026-04-01&to=2026-04-30" \
  -H "Authorization: Bearer ct_your_api_key_here" \
  -o downloads-april.csv

Real-time Tracking

Continuata does not currently push outbound webhook events on download progress. For monitoring, the dashboard Overview updates in near real time, and the CSV report above lets you reconcile sessions in batch.

In-Dashboard Analytics: For interactive analytics, the Overview in the app shows download volume, completion rates, and per-product breakdowns. The CSV export above is the same underlying data.