Skip to main content
GET
Run a report

Authorizations

Authorization
string
header
required

An organization API key, created in Settings → Integrations → API keys. Keys start with mk_live_. Marro stores only a hash of a key, so it is shown once, when it is created: copy it then. Revoking a key ends its access at once. To replace a key without downtime, create the new one, switch your server to it, then revoke the old one. Changes made with a key appear on the lead’s timeline as made by the person who created the key, via the API. Scopes: objects.records.read (Read custom objects), objects.records.write (Create and update custom-object records), objects.records.delete (Delete custom-object records), leads.read (Read leads), leads.write (Create and update leads), leads.capture (Capture leads), crm.records.read (Read customers and opportunities), crm.records.write (Create and update customers and opportunities), reports.read (Read reports), money.read (Read products, quotes, invoices and payments), money.write (Create quotes and invoices and record payments), agent.tools (AI agent tools (MCP)).

Scopes

reports.read

Path Parameters

reportId
integer
required

The report’s ID, from List reports.

Required range: x >= 1

Query Parameters

period
enum<string>

Overrides the saved period. "custom" needs from and to.

Available options:
today,
7d,
30d,
90d,
this_month,
custom
from
string

First day, YYYY-MM-DD on the organization calendar (with period=custom).

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

Last day, YYYY-MM-DD (with period=custom).

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

Response

The figures.

report
object
required
measure
string
required
unit
enum<string>
required
Available options:
count,
percent,
minutes,
seconds,
days,
number
groupBy
string | null
required
splitBy
string | null
required
period
object | null
required
total
number | null
required
previousTotal
number | null
required

The period before, for a number report of up to 92 days.

records
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
series
object[]
required
groups
object[]
required
hiddenGroups
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
truncated
boolean
required