Skip to main content
POST
Exports raw, per-scan analytics records — one row per scan event, rather than the aggregated breakdowns QR analytics and Export analytics return.
This is a POST-only endpoint — a GET request returns 405 Method Not Allowed. The management-api.json spec previously listed it as GET; this has been corrected.
Requires a Management API key with MANAGEMENT_API quota — see the Management API overview — plus the account’s EXPORT_ANALYTICS_REPORT quota and ANALYTICS_CAN_EXPORT_RAW permission (distinct from the ANALYTICS_CAN_EXPORT permission the aggregated export requires — a role can have one without the other). A 403 with "Your plan does not have export analytics report quota." means the plan doesn’t include exports.

​
Request

This endpoint always returns a binary file, not JSON.

​
Query parameters

​
string
required
Start date (YYYY-MM-DD), inclusive.
​
string
required
End date (YYYY-MM-DD), inclusive.
​
string
required
csv, xls, or xlsx. Unlike Export analytics, pdf is not a supported format here. Any other value (or omitting it) returns a 400 with "Invalid file format".
​
string
Pass raw_bot to export only bot-identified scan records instead of all scans. Any other value is overwritten — this endpoint always exports raw data regardless of what you pass here.

​
Request body

Same shape as QR analytics — q (required) and filter_by (default qrid) scope which QR codes’ raw scans to include, and the same QR-count/date-range volume cap applies.
​
array
required
Identifiers to scope the export to — type depends on filter_by.
​
string
default:"qrid"
qrid, id, tags, or folder.

​
Response formats

Returns a single CSV (text/csv, analytics_raw.csv) of raw scan rows.
If the account has event tracking analytics enabled and file_format isn’t csv, a second sheet/section of raw event-tracking records (session ID, timestamp, QR code ID/name, user-specified event tracking ID, URL hash, URL) is appended automatically. Requesting csv always returns scan records only — event-tracking rows are omitted for that format specifically.
  • QR analytics — the aggregated, JSON equivalent of these raw scan records.
  • Export analytics — export aggregated metric breakdowns instead of row-level scan data.
  • Management API overview — the auth scheme and quota architecture this endpoint is part of.

Authorizations

​
Authorization
string
header
required

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. management.scanova.io) — the same key sent to the regular API host will not authenticate.

Query Parameters

​
from
string<date>
required
​
to
string<date>
required
​
file_format
enum<string>
required
Available options:
csv,
xls,
xlsx
​
type
enum<string>

Pass raw_bot for a bot-only export; any other value is overwritten to raw.

Available options:
raw_bot

Body

application/json
​
q
string[]
required
​
filter_by
enum<string>
default:qrid
Available options:
qrid,
tags,
id,
folder

Response

Binary file download — text/csv for csv, spreadsheet mimetype for xls/xlsx.