List conversion events

THE CALL, PART BY PART

method

GET

host

strait.link

version

/v1

resource

/events

GET /v1/events

Auth: secret key as Authorization: Bearer. Server-side only.

Request

Every conversion event, oldest first, as cursor pages: { events, nextCursor }. An event that came from a tap carries that tap's link, channel, campaign and variant. The same rows as GET /v1/export?part=events. Secret key with read or full access; 30 reads a minute per workspace, shared with GET /v1/taps.

Parameters

limit integer query
1–100, default 50
cursor string query
nextCursor from the previous page
from string query
Inclusive start: ISO date (UTC), ISO date-time or epoch ms
to string query
Exclusive end, same formats
name string query
Only events with this name, e.g. purchase

Response

  • 200 A page of events
  • 400 Bad limit, cursor, from / to or name
  • 401 Missing or invalid secret key, or a publishable key
  • 403 The key is limited to links
  • 429 Over 30 reads a minute for this workspace (Retry-After)
Request · curl
curl -X GET https://strait.link/v1/events \
  -H "Authorization: Bearer $SECRET_KEY"

The response, printed

Response 200
{
  "events": [
    {
      "id": "5d2f8a1b-3c4e-4f6a-9b8c-1e2d3f4a5b6c",
      "createdAt": "2026-10-01T10:05:00.000Z",
      "name": "purchase",
      "value": 1499,
      "currency": "INR",
      "platform": "android",
      "linkId": "lnk_5f0c2a8e-3b1d-4f6a-9c7e-2d8b1a0e4f63",
      "slug": "summer",
      "clickId": "9a1c7e52-4b3d-4f8e-a1c2-7d6e5f4a3b21",
      "channel": "whatsapp",
      "campaign": "diwali",
      "variant": null
    }
  ],
  "nextCursor": null
}