# List conversion events

Source: https://straitlink.in/docs/api/list-events/

`GET /v1/events`

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

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.

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

```bash
curl -X GET https://strait.link/v1/events \
  -H "Authorization: Bearer $SECRET_KEY"
```

Response 200:

```json
{
  "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
}
```

- `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)