Conversion Events

List conversion events (incremental sync)

Events in the order they last CHANGED (updatedAt, then eventId), oldest first — built for incremental sync. Keep the response’s nextCursor and send it as since next time: you receive every new event and every later change to one (a delivery outcome, an adjustment) exactly once more. While hasMore is true, fetch again at once.

Filters narrow the page; from / to filter on when the conversion happened (occurredAt), since on when it last changed.

Fields the visitor’s consent did not allow are absent. The visitor’s IP address and user agent are never returned.

Access: an API key with conversions:read — or its group master ads:all, or admin:all — or a signed-in user holding the conversion-events:view permission. Anonymous callers get 404.

Rate limit: the key’s own reads-per-minute limit, set when the key is created (default 600); over it, 429 with Retry-After.

GET

conversion-event

cURL

curl --request GET \
  --url https://{host}/api/v1/conversion-event \
  --header 'Authorization: <api-key>'

{
  "events": [
    {
      "eventId": "b8f2c1de-4f5a-4c1e-9a53-0d6f2b7c1e9a",
      "conversion": {
        "id": "ckq1w2e3r4t5y6u7i8o9p0",
        "key": "quote-request",
        "title": "Quote request"
      },
      "trigger": {
        "type": "form",
        "ref": "ckformid123"
      },
      "source": "browser",
      "occurredAt": "2026-09-21T15:04:05.000Z",
      "recordedAt": "2026-09-21T15:04:05.412Z",
      "updatedAt": "2026-09-21T15:04:07.020Z",
      "page": {
        "url": "https://example.com/contact?gclid=Cj0KCQjw",
        "path": "/contact",
        "referrer": "https://www.google.com"
      },
      "visitorId": "0b8e6a4c-8d2f-4b6e-9a1c-3f5d7e9b1a2c",
      "attribution": {
        "firstTouch": {
          "at": "2026-09-20T09:12:00.000Z",
          "path": "/",
          "landingUrl": "https://example.com/?gclid=Cj0KCQjw",
          "referrerOrigin": "https://www.google.com",
          "adPlatforms": [
            "google"
          ],
          "campaign": {
            "utm_source": "google",
            "utm_campaign": "spring-sale"
          },
          "clickIds": {
            "gclid": "Cj0KCQjw"
          }
        },
        "adPlatforms": [
          "google"
        ],
        "campaign": {
          "utm_source": "google",
          "utm_campaign": "spring-sale"
        },
        "clickIds": {
          "gclid": "Cj0KCQjw"
        },
        "browserIds": {
          "_gcl_au": "1.1.1234567890.1790000000"
        },
        "provenance": {
          "gclid": "ourRecord",
          "_gcl_au": "platformCookie"
        }
      },
      "consent": {
        "categories": {
          "analytics": true,
          "marketing": true
        },
        "mode": "lenient",
        "country": "US",
        "gpc": false,
        "policyVersion": 7
      },
      "value": 50,
      "currency": "USD",
      "userData": {
        "emailSha256": "b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514",
        "phoneSha256": "b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514",
        "phoneDigitsSha256": "b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514"
      },
      "submissionId": "ck9submission1",
      "delivery": {
        "google-ads": {
          "browser": "sent",
          "server": {
            "status": "sent",
            "attempts": 1,
            "sentAt": "2026-09-21T15:04:07.001Z",
            "lastAttemptAt": "2026-09-21T15:04:07.001Z"
          }
        },
        "ga4": {
          "browser": "sent",
          "server": {
            "status": "n/a",
            "attempts": 0
          }
        }
      },
      "status": "active",
      "adjustments": []
    }
  ],
  "nextCursor": "eyJ1IjoiMjAyNi0wOS0yMVQxNTowNDowNy4wMjBaIiwiZSI6ImI4ZjJjMWRlLTRmNWEtNGMxZS05YTUzLTBkNmYyYjdjMWU5YSJ9",
  "hasMore": false
}

{
  "name": "invalid",
  "message": "The query is not valid.",
  "data": {
    "errors": [
      {
        "name": "invalid",
        "code": 400,
        "path": "limit",
        "message": "A whole number from 1 to 500.",
        "data": {}
      }
    ]
  }
}

{
  "name": "unauthorized",
  "message": "X-Fetchski-Signature does not match this request.",
  "data": {}
}

{
  "name": "forbidden",
  "message": "This API key lacks the required scope: conversions:read.",
  "data": {}
}

{
  "name": "notfound",
  "message": "No event with this ID.",
  "data": {}
}

{
  "name": "tooManyRequests",
  "message": "This API key’s rate limit is used up for this minute.",
  "data": {
    "retryAfter": 12
  }
}

Authorizations

Authorization

string

header

required

Paste your API key as the CMS showed it: fsk_<site>_<key id>_<secret> (issued under API Keys). ApiKey in front of it works too. Leave it empty to read as the public.

Scopes

conversions:read

Query Parameters

since

string

The previous page’s nextCursor, or an ISO 8601 time (changes strictly after it). Omit to start from the beginning.

limit

integer

default:100

Events per page: 1 to 500, 100 when left out (a value outside is refused, 400).

Required range: 1 <= x <= 500

conversion

string

A Conversion’s id or key.

Maximum string length: 256

platform

enum<string>

Events that report to this platform.

Available options:

google-ads,

ga4,

gtm,

meta,

tiktok

visitorId

string

One visitor’s events.

Maximum string length: 128

source

enum<string>

Where the event was born: the page (browser), this server, or another system (external).

Available options:

browser,

server,

external

status

enum<string>

active, retracted or adjusted (restated).

Available options:

active,

retracted,

adjusted

utmCampaign

string

The utm_campaign of the event’s attribution.

Maximum string length: 256

from

string<date-time>

Happened at or after (ISO 8601 date or time).

string<date-time>

Happened before (ISO 8601 date or time).

Response

A page of events.

events

object[]

required

Show child attributes

nextCursor

string | null

required

Pass as since to continue. When the page is empty it echoes the since you sent — keep polling with it.

hasMore

boolean

required

More changes are waiting right now; fetch again at once.

cURL

curl --request GET \
  --url https://{host}/api/v1/conversion-event \
  --header 'Authorization: <api-key>'

{
  "events": [
    {
      "eventId": "b8f2c1de-4f5a-4c1e-9a53-0d6f2b7c1e9a",
      "conversion": {
        "id": "ckq1w2e3r4t5y6u7i8o9p0",
        "key": "quote-request",
        "title": "Quote request"
      },
      "trigger": {
        "type": "form",
        "ref": "ckformid123"
      },
      "source": "browser",
      "occurredAt": "2026-09-21T15:04:05.000Z",
      "recordedAt": "2026-09-21T15:04:05.412Z",
      "updatedAt": "2026-09-21T15:04:07.020Z",
      "page": {
        "url": "https://example.com/contact?gclid=Cj0KCQjw",
        "path": "/contact",
        "referrer": "https://www.google.com"
      },
      "visitorId": "0b8e6a4c-8d2f-4b6e-9a1c-3f5d7e9b1a2c",
      "attribution": {
        "firstTouch": {
          "at": "2026-09-20T09:12:00.000Z",
          "path": "/",
          "landingUrl": "https://example.com/?gclid=Cj0KCQjw",
          "referrerOrigin": "https://www.google.com",
          "adPlatforms": [
            "google"
          ],
          "campaign": {
            "utm_source": "google",
            "utm_campaign": "spring-sale"
          },
          "clickIds": {
            "gclid": "Cj0KCQjw"
          }
        },
        "adPlatforms": [
          "google"
        ],
        "campaign": {
          "utm_source": "google",
          "utm_campaign": "spring-sale"
        },
        "clickIds": {
          "gclid": "Cj0KCQjw"
        },
        "browserIds": {
          "_gcl_au": "1.1.1234567890.1790000000"
        },
        "provenance": {
          "gclid": "ourRecord",
          "_gcl_au": "platformCookie"
        }
      },
      "consent": {
        "categories": {
          "analytics": true,
          "marketing": true
        },
        "mode": "lenient",
        "country": "US",
        "gpc": false,
        "policyVersion": 7
      },
      "value": 50,
      "currency": "USD",
      "userData": {
        "emailSha256": "b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514",
        "phoneSha256": "b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514",
        "phoneDigitsSha256": "b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514"
      },
      "submissionId": "ck9submission1",
      "delivery": {
        "google-ads": {
          "browser": "sent",
          "server": {
            "status": "sent",
            "attempts": 1,
            "sentAt": "2026-09-21T15:04:07.001Z",
            "lastAttemptAt": "2026-09-21T15:04:07.001Z"
          }
        },
        "ga4": {
          "browser": "sent",
          "server": {
            "status": "n/a",
            "attempts": 0
          }
        }
      },
      "status": "active",
      "adjustments": []
    }
  ],
  "nextCursor": "eyJ1IjoiMjAyNi0wOS0yMVQxNTowNDowNy4wMjBaIiwiZSI6ImI4ZjJjMWRlLTRmNWEtNGMxZS05YTUzLTBkNmYyYjdjMWU5YSJ9",
  "hasMore": false
}

{
  "name": "invalid",
  "message": "The query is not valid.",
  "data": {
    "errors": [
      {
        "name": "invalid",
        "code": 400,
        "path": "limit",
        "message": "A whole number from 1 to 500.",
        "data": {}
      }
    ]
  }
}

{
  "name": "unauthorized",
  "message": "X-Fetchski-Signature does not match this request.",
  "data": {}
}

{
  "name": "forbidden",
  "message": "This API key lacks the required scope: conversions:read.",
  "data": {}
}

{
  "name": "notfound",
  "message": "No event with this ID.",
  "data": {}
}

{
  "name": "tooManyRequests",
  "message": "This API key’s rate limit is used up for this minute.",
  "data": {
    "retryAfter": 12
  }
}

Get started

How the API works

Pages & Site

Content

Media

Forms

Ads & Conversions

Analytics

Signing in (people)

List conversion events (incremental sync)

Authorizations

Scopes

Query Parameters

Response