---
title: "List stored events"
method: GET
path: "/v1/events"
tags: ["Conversions"]
---

# List stored events

`GET /v1/events`

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/events`
- Auth: HTTP bearer

Lists the conversion events stored for a profile by `POST /v1/events`, newest first. Personal data is never
returned: `hasEmail`, `hasPhone` and `hasExternalId` only say whether the event carried that identifier.
Events sent with `testCode` are not stored, so they never appear here.

Paginate with `cursor`: pass the `nextCursor` of the previous page until it comes back `null`.

## Query parameters

- `profileId` string, required
- `limit` integer
- `from` string, date-time
- `to` string, date-time
- `eventName` string
- `cursor` string

## Response `200`

A page of stored events.

- object
  - `events` object[]
    - `eventId` string
    - `eventName` string
    - `eventTime` string, date-time
    - `receivedAt` string, date-time
    - `actionSource` string, nullable
    - `value` number, nullable
    - `currency` string, nullable
    - `sourceUrl` string, nullable: Origin, path and attribution parameters only.
    - `utm` object
      - `source` string, nullable
      - `medium` string, nullable
      - `campaign` string, nullable
      - `content` string, nullable
    - `zrn` string, nullable: Ad ID from the `zrn` parameter Zernio adds to links of ads it creates.
    - `clickIds` object
      - `gclid` string, nullable
      - `fbc` string, nullable
    - `destinationsSent` integer: Destinations the event was forwarded to.
    - `hasEmail` boolean
    - `hasPhone` boolean
    - `hasExternalId` boolean
    - `ad` object, nullable: The ad behind the event, when Zernio can name it. Google: from the click behind `clickIds.gclid` (synced daily from Google Ads click_view for clicks up to 14 days before the event; gbraid/wbraid clicks are not resolved). Meta: from the `zrn` ad id, for Meta ads Zernio holds. `null` otherwise.
      - `platform` 'googleads' | 'metaads'
      - `customerId` string: Google Ads customer id (Google only).
      - `campaignId` string, nullable
      - `adGroupId` string, nullable: Google only.
      - `adSetId` string, nullable: Meta only.
      - `adId` string, nullable
  - `nextCursor` string, nullable: Pass as `cursor` to get the next page; `null` on the last page.

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key. `code` is `missing_credentials` when no Authorization header was sent and `invalid_credentials` when the key is unknown, revoked or expired.
- `404`: Resource not found

## Changes

- **2026-10-27** `a68973d39286`: 1 info
  - added the optional property `events/items/ad` to the response with the `200` status
- **2026-10-27** `b61062323c2e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/events/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) - [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/c319eb5d95b6?raw)