List Referral Activity

Lists the View rows attached to one referral — link clicks (type="ref") and ticket purchases (type="purchase"). Sorted newest first.

Authorization

AuthorizationRequiredBearer <token>

API key as Bearer token

In: header

Path Parameters

idRequiredstring

Referral id, discoverable via list_referrals

Query Parameters

event_idstring

Narrow to one event

typestring

Narrow to one view type

Value in: "ref" | "purchase" | "view"

GET/v1/referrals/{id}/views

curl -X GET "https://api.3common.com/v1/referrals/string/views?event_id=string&type=ref" \
  -H "Authorization: Bearer <token>"

Default Response

Response

{
  "data": [
    {
      "id": "string",
      "type": "ref",
      "ref_id": "string",
      "event_id": "string",
      "hour": 0,
      "hashes": [
        "string"
      ],
      "value": 0,
      "tickets": 0,
      "order_id": "string",
      "createdAt": 0,
      "updatedAt": 0
    }
  ]
}

TypeScript

export interface Response {
  data: {
    id: string;
    /**
     * View row type.
     * - ref:      counted hit on a referral link
     * - view:     general event-page view (no ref_id)
     * - purchase: ticket purchase that came through this referral
     */
    type: "ref" | "purchase" | "view";
    ref_id?: string;
    event_id?: string;
    hour: number;
    hashes?: string[];
    value?: number;
    tickets?: number;
    order_id?: string;
    createdAt: number;
    updatedAt: number;
  }[];
}