Skip to main content
GET
List display performance

Authorizations

Authorization
string
header
required

Send either an API token or an OAuth access token as Authorization: Bearer <token>. See the Authentication page for details.

Headers

Privy-Account-Id
string

Target a subaccount instead of the main connected account. Pass a subaccount id from get_account's subaccounts list. Only direct subaccounts of the connected account are reachable — omit this for the main account itself.

Query Parameters

period
enum<string>
default:last_30_days

The date range to report over, resolved in the account's time zone. Pass custom together with start_date and end_date.

Available options:
last_7_days,
last_30_days,
last_90_days,
this_month,
last_month,
custom
start_date
string<date>

Inclusive start of a custom period (ISO 8601 date). Required when period=custom, ignored otherwise.

end_date
string<date>

Inclusive end of a custom period (ISO 8601 date). Required when period=custom, ignored otherwise. Custom periods are capped at 366 days.

sort
enum<string>
default:signups

The metric to rank displays by, best first.

Available options:
signups,
signup_rate,
views,
revenue,
orders
page
integer
default:1

Page number (starts at 1).

Required range: x >= 1
per_page
integer
default:40

Number of results per page. Values outside 10–100 are clamped to the nearest bound.

Required range: 10 <= x <= 100

Response

Displays ranked by the requested sort, with the resolved period.

data
object[]
period
object

The resolved date range the report covers, inclusive, in the account's time zone. Every label except last_month ends today, so the last day of the range is still in progress: last_7_days is the six days before today plus today, this_month runs from the 1st through today, and last_month is the whole previous calendar month. Custom ranges cannot exceed 366 days.

pagination
object