AdonisJSConversion Events
Get one conversion event
One event by its event ID.
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
/
{eventId}
cURL
curl --request GET \
--url https://{host}/api/v1/conversion-event/{eventId} \
--header 'Authorization: <api-key>'import { createSiteClient } from '@fetchski/attract-cms-sdk';
const site = createSiteClient();
const getConversionEvent = await site.conversionEvents().getConversionEvent({ eventId: 'tenant-42:order:1234:purchase' });use Fetchski\AttractCmsLaravel\Facades\Attract;
$getConversionEvent = Attract::conversionEvents()->getConversionEvent(eventId: 'tenant-42:order:1234:purchase');{
"event": {
"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": []
}
}{
"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
Path Parameters
The event ID.
Opaque, unique per site, stable. The CMS mints a UUID for events it originates; another system mints its own (e.g. tenant-42:order:1234:purchase). Forwarded unchanged to every ad platform as its de-duplication key.
Maximum string length:
128Pattern:
^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$Example:
"tenant-42:order:1234:purchase"
Response
The event.
One conversion occurrence. Fields the visitor’s consent did not allow are ABSENT, not empty. Never returned: the visitor’s IP address and user agent, outbox lease and retry bookkeeping.
Show child attributes
Show child attributes
Example:
{
"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": []
}
⌘I
cURL
curl --request GET \
--url https://{host}/api/v1/conversion-event/{eventId} \
--header 'Authorization: <api-key>'import { createSiteClient } from '@fetchski/attract-cms-sdk';
const site = createSiteClient();
const getConversionEvent = await site.conversionEvents().getConversionEvent({ eventId: 'tenant-42:order:1234:purchase' });use Fetchski\AttractCmsLaravel\Facades\Attract;
$getConversionEvent = Attract::conversionEvents()->getConversionEvent(eventId: 'tenant-42:order:1234:purchase');{
"event": {
"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": []
}
}{
"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
}
}