Skip to main content

Authentication

This route is for the app owner’s merchant session, never an app_ token:
days is a whole number from 1 to 365. It defaults to 30, and an unparseable value also falls back to 30. The window is UTC days ending today.

Response

The headline fields

apiCalls and apiErrors come from per app, per UTC day counters with a 40 day retention. Days older than 40 days read as zero, so a 365 day window shows API usage for its last 40 days only. When the counter store is unavailable the response reports zeroes rather than an estimate. webhookDeliveries and webhookFailures come from the delivery log, which keeps 14 days of rows. A longer window therefore covers only the last 14 days of webhook history.

The daily series

  • series is one row per UTC day, oldest first: installs, uninstalls and the live active count at the end of that day. The active series is exact over the window because it is derived from the live count and the net change after each day.
  • totals.churnRate is the share of the installs active at the start of the window that were removed during it. It is null when nothing was active to churn.
  • ratings.distribution always has the five keys 1 to 5. inWindow counts reviews updated in the window.
  • revenue is one entry per currency. Amounts are never converted: an app paid in USD and NGN gets two entries. Test charges are excluded.

Errors

Next steps

Webhook deliveries

See the attempts behind the webhook numbers.

Releases

Stage a change and watch its effect on installs.