API introduction

TrackRev exposes a small, predictable REST API for reading your tracking data and driving referral programmes, plus signed outbound webhooks for real-time events.

Base URL

https://app.trackrev.io/api/v1

All endpoints return JSON, accept and return UTF-8, and support CORS (so browser-safe endpoints can be called with a publishable key from any origin).

Quick example

curl "https://app.trackrev.io/api/v1/channels?days=30&ltv=1" \
  -H "Authorization: Bearer <your secret key>"

{
  "window": { "from": "2026-06-21T00:00:00.000Z", "to": "2026-07-21T00:00:00.000Z" },
  "channels": [
    { "channel": "newsletter", "clicks": 1204, "visitors": 980, "conversions": 47, "revenue": 4231.5, "ltv": 9120.0 }
  ]
}

What you can do

Read analytics

Channels, Links, Clicks and Visitor journeys.

Drive referrals

Enroll referrers and report signups for product-led referral programmes.

Manage credit rewards

List grants and mark them delivered.

React to events

Subscribe to signed webhooks for clicks, leads, sales and commissions.

Before you start

The API is a paid-plan feature. Every /api/v1 endpoint requires the workspace to be on an active paid plan; free workspaces receive a 402. Generate keys under Settings → Developers.

Create an API key

See Authentication.

Make an authenticated request

Send your key as a Bearer token.

Handle errors and paginate

See Errors and Rate limits & pagination.

Authentication

⌘I

API Reference

Endpoints

Events & embeds

Base URL

Quick example

What you can do

Read analytics

Drive referrals

Manage credit rewards

React to events

Before you start

​Base URL

​Quick example

​What you can do

Read analytics

Drive referrals

Manage credit rewards

React to events

​Before you start

Base URL

Quick example

What you can do

Before you start