Skip to main content
GET
Get KPIs

Authorizations

Authorization
string
header
required

An API key (mana_api_...) with scopes. It reads reports and writes profile properties.

Path Parameters

projectId
string<uuid>
required

The project ID

Query Parameters

date_from
string

First day (UTC) as YYYY-MM-DD. Default: 29 days before date_to.

Pattern: ^\d{4}-\d{2}-\d{2}$
date_to
string

Last day (UTC) as YYYY-MM-DD. Default: today. The range is at most 367 days.

Pattern: ^\d{4}-\d{2}-\d{2}$
page_path
string

Only events on this page path

Maximum string length: 2048
Pattern: ^\/
utm_source
string
Maximum string length: 255
utm_medium
string
Maximum string length: 255
utm_campaign
string
Maximum string length: 255
utm_content
string
Maximum string length: 255
utm_term
string
Maximum string length: 255
ref
string

Referral code (ref link parameter)

Maximum string length: 255
paid_source
enum<string>

Ad network of a paid click

Available options:
google,
meta,
microsoft,
tiktok,
twitter,
linkedin,
reddit,
snapchat,
paid_utm
click_id
string

Ad click ID (gclid, fbclid and others)

Maximum string length: 255
channel_type
enum<string>

Acquisition channel

Available options:
Paid Search,
Paid Video,
Paid Social,
Paid Other,
Email,
Referrals,
Display,
AI,
Organic Search,
Organic Social,
Organic Video,
Referrers,
Direct
referrer
string

Referrer origin, for example https://www.reddit.com

Maximum string length: 2048
locale
string
Maximum string length: 32
device
enum<string>
Available options:
desktop,
mobile,
tablet,
bot
os
enum<string>
Available options:
windows,
macos,
ios,
android,
linux,
other
browser
enum<string>
Available options:
chrome,
safari,
firefox,
edge,
opera,
other
country
string

ISO 3166-1 alpha-2 country code

Pattern: ^[A-Za-z]{2}$
currency
string

Report currency for revenue (ISO 4217). Default: USD.

Pattern: ^[A-Z]{3}$
currency_mode
enum<string>

convert (default) converts other currencies with the rate of the event day. only counts the report currency alone.

Available options:
convert,
only
filters
string

Operator filters as a JSON array of { "field", "op", "value" }, combined with AND. At most 20.

Maximum string length: 8192

Response

The report

date_from
string
required

First day of the report

Pattern: ^\d{4}-\d{2}-\d{2}$
date_to
string
required

Last day of the report

Pattern: ^\d{4}-\d{2}-\d{2}$
rows
object[]
required
totals
object

Range totals (event-timeseries only). visitors is the unique count for the range; the other values are sums of all days.

notes
string[]

Fixed sentences on how to read the session columns, or why they are absent