Skip to main content
POST
Export raw analytics

Description

The Export Raw Scan Data endpoint returns a flat dataset where each row equals one scan event. Use it when you need to rebuild your own pivot tables, send the data to a warehouse, or debug anomalies at the event level. The query parameters mirror those in the analytics export endpoint so you can reuse the same request builder.

Query Parameters

Supported type Values

Request Body

When using form-data, pass one q field per ID or tag (for example: q=Qf94..., q=Qf95...).

Example Request

Export Raw Scan Data by QR IDs

Export Raw Scan Data by Tags

Export Bot-Only Scan Data

Response

  • Status: 200 OK on success.
  • Content-Type: Matches the requested format (text/csv, application/vnd.ms-excel, or application/vnd.openxmlformats-officedocument.spreadsheetml.sheet).
  • Body: Each row represents a scan with timestamp, device, OS, browser, geo metadata, campaign references, and any other available scan attributes.
Raw files can grow quickly when exporting long date ranges or busy campaigns. For >50k scans, schedule the job during off-hours or break the date range into weekly slices.

Tips

  • Pair this export with the aggregate /analytics/qr/export/ report to validate funnel metrics.
  • CSV output is best suited for ETL/ELT jobs and scripting workflows.
  • XLS/XLSX provide richer formatting if you need to hand the dataset to stakeholders without additional tooling.

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.