Skip to main content
GET
Get partner report

Authorizations

Authorization
string
header
required

Partner server key (tpk_...), issued by Totalis to a registered partner. It calls only POST /v1/partner/wallet-admissions and GET /v1/partner/report, from the partner's server with no Origin; it cannot act for an account. Never ship it to a browser: pages use the publishable browser key (X-Totalis-Partner: tpb_...), which labels traffic but authorizes nothing.

Query Parameters

from
string

First UTC day of the range, inclusive. Send from and to together, at most 366 days apart; omit both for the 30 days through today.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
to
string

UTC day after the range, exclusive: from=2026-10-01&to=2026-11-01 is October.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$

Response

Your report. Balance, terms and payouts are all time; days and totals cover the range. No caching.

A partner's own report: the figures Totalis pays from. Amounts are atomic USDC (6 decimals) decimal strings.

partner
string
required

Your partner slug.

as_of
string<date-time>
required

When the report was read.

Maximum string length: 30
Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}([.][0-9]{1,9})?Z$
balance
object
required

What you have earned, been paid and are owed, all time.

terms
object[]
required

Your terms, oldest first; each holds from its day until the next.

from
string
required

First UTC day of the range.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
to
string
required

UTC day after the range.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
totals
object
required

The range's days added up.

days
object[]
required

Each UTC day in the range with fees, oldest first; days without fees are absent.

payouts
object[]
required

Every payout to you, newest first.