Skip to main content

GET Single Conversion Details

Returns conversion details of a single conversion record

Written by GoKart Support

Endpoint

GET /api/v1/sdk-conversion-system/conversions/{id}

This endpoint retrieves a single conversion record by its unique Conversion ID.

Each record includes full attribution details, revenue and payout information, user and device metadata, and reward status, enabling comprehensive performance tracking and reporting.

For multi-event offers, each conversion also includes a nested conversionEvents array representing funnel-level event data. This provides deeper visibility into each step of a user’s conversion journey within a single session, allowing detailed analysis of event progression, completion behavior, and reward distribution at the event level.


Product Path Parameter

Name

Type

Description

{id}

string (UUID)

The Conversion ID record


Response Overview

  • Returns the general response schema here

Default Response Fields

Response scheme is identical to the per-item scheme documented above for GET .../conversions.

Field Name

Type

Description

Example

id

string (UUID)

Conversion ID

3fa85f64-5717-4562-b3fc-2c963f66afa6

createdAt

string ($date-time)

Date & time the conversion record was created

2026-03-15T10:30:00Z

modifiedAt

string ($date-time)

Date & time the conversion status was last updated

2026-03-15T11:00:00Z

isRepeated

boolean

Indicates if this is a repeated conversion

false

status

string

Conversion status

Success

rejectionReason

string

Reason the conversion was rejected

IP address is not whitelisted

isUserCompleted

boolean

Indicates if the user completed the conversion

true

userCompletedAt

string ($date-time)

Date & time the user completed the conversion

2026-03-15T10:45:00Z

isRewardSent

boolean

Indicates whether the reward callback was sent

true

partnerName

string

Partner that generated the conversion

PartnerA

partnerId

string (UUID)

Partner identifier

3fa85f64-5717-4562-b3fc-2c963f66afa6

revenue

number

Revenue generated from the conversion

5.50

payout

number

Payout amount for the conversion

2.00

trackingSystemIp

string

IP address of the tracking system postback

203.0.113.42

rewardingType

string

Rewarding method

Automatic

pendingTime

number

Number of days the conversion status remains Pending

7

offerType

string

Type of offer

SingleEvent

conversionType

string

Revenue model type

FlatRate

offerSource

string

Source of the offer

GoKart

isGoKartOrigin

boolean

Indicates if conversion originated from GoKart

true

trackingSystem

string

Attribution provider of the offer

AppsFlyer

placementId

string (UUID)

Placement identifier

3fa85f64-5717-4562-b3fc-2c963f66afa6

firstClickAt

string ($date-time)

Date & time the user first clicked the offer

2026-03-15T09:00:00Z

clickTime

string ($date-time)

Date & time the conversion click occurred

2026-03-15T10:00:00Z

source

string

Source of the conversion record

0 = GoKartPostback
1 = GoKartApi
2 = Manually created / uploaded

1

viewId

string (UUID)

Offer view identifier

3fa85f64-5717-4562-b3fc-2c963f66afa6

clickId

string (UUID)

Offer click identifier

3fa85f64-5717-4562-b3fc-2c963f66afa6

pubMemberId

string

Publisher member/user identifier

user_123

pubSessionId

string

Publisher session identifier

sess_abc

pubGender

string

User gender

male

pubAge

string

User age

25

pubGeoCountry

string

User country

US

pubGeoState

string

User state

CA

pubPostalCode

string

User postal code

90210

pubClickId

string

Publisher click identifier

click_xyz

pubSub1 – pubSub15

string

Publisher custom sub parameters 1–15

value1

pubDevice

string

Device type associated with the conversion

iOS

offerId

string (UUID)

Unique identifier of the offer

3fa85f64-5717-4562-b3fc-2c963f66afa6

offerName

string

Name of the offer

My Offer

offerAdvertiserId

string (UUID)

Advertiser identifier

3fa85f64-5717-4562-b3fc-2c963f66afa6

offerAdvertiserName

string

Advertiser name

BrownBoots

offerCategoryId

string (UUID)

Category identifier

3fa85f64-5717-4562-b3fc-2c963f66afa6

offerCategoryName

string

Category name

Finance

reward

number

Reward amount for the conversion

2

trackSysEventId

string

External tracking system event identifier

Level 1

trackSysConversionId

string

External tracking system conversion identifier

conv_67890

trackSysConversionAmount

string

Conversion amount reported by the tracking system

49.99

trackSysConversionIpAddress

string

Conversion IP address reported by the tracking system

203.0.113.42

trackSysConversionEmail

string

Conversion email reported by the tracking system

trackSysConversionUserId

string

Conversion user ID reported by the tracking system

user_abc

trackSysConversionSub1 – trackSysConversionSub5

string

Tracking system custom sub parameters 1–5

sub_value_1

deviceBrand

string

Device brand

Apple

deviceModel

string

Device model

iPhone 15

deviceOs

string

Device operating system

iOS 17.4

deviceCategory

string

Device category

Phone

deviceUserAgent

string

Device user agent

Mozilla/5.0

deviceCountry

string

Device country

US

deviceCountryState

string

Device state/region

California

clientIp

string

Client IP address

198.51.100.1

conversionEvents

array

Nested funnel conversion events. Only populated for MultiEvent offers

see below

conversionEvent Array Fields

These fields belong to a nested funnel conversion event inside the parent conversion. Field names may overlap with the parent conversion object, but refer specifically to the event-level record inside the conversion chain.

Name

Type

Description

Example

id

string (UUID)

Conversion Event ID of the nested funnel event

3fa85f64-5717-4562-b3fc-2c963f66afa6

createdAt

string ($date-time)

Date & time the nested event was created

2026-03-15T10:30:00Z

modifiedAt

string ($date-time)

Date & time the nested event's status was last updated

2026-03-15T11:00:00Z

isRepeated

boolean

Indicates if this is a repeated conversion

false

status

string

Conversion status of the nested event

Success

rejectionReason

string

Reason the event was rejected

IP address is not whitelisted

isUserCompleted

boolean

Indicates if the user completed the event

true

userCompletedAt

string ($date-time)

Date & time the user completed the conversion

2026-03-15T10:45:00Z

conversionId

string (UUID)

Parent conversion identifier

3fa85f64-5717-4562-b3fc-2c963f66afa6

payout

number

Payout amount for the conversion

1.00

offerEventId

string (UUID)

Offer event idenfitier

3fa85f64-5717-4562-b3fc-2c963f66afa6

pendingTime

number

Number of days the conversion status remains Pending

1440

isRevenuePerEvent

boolean

Indicates revenue is tracked per event

true

isRewardSent

boolean

Indicates whether the reward callback was sent

true

trackingSystemIp

string

IP address from tracking system postback

203.0.113.42

name

string

Event name

Install

showOnOfferWall

boolean

Indicates if event is shown on offer wall

true

eventId

string

External event identifier

evt_install

displayOrder

number

Display order of the event

1

sequenceNumber

number

Sequence position (null if independent)

null

minTimeFromPreviousEvent

number

Minimum time (minutes) from previous event

null

deadlineDays

number

Days allowed to complete the event

30

revenue

number

Revenue generated from the conversion

2.50

hasReward

boolean

Indicates if the event has a reward

true

useDefaultRatio

boolean

Indicates if the event uses default reward/revenue ratio

true

reward

number

Reward amount for the event

1.00

trackSysConversionId

string

Tracking system conversion ID

conv_67890

trackSysConversionAmount

string

Conversion amount from tracking system

49.99

trackSysConversionIpAddress

string

Tracking system IP address

203.0.113.42

trackSysConversionEmail

string

Email tied to conversion

trackSysConversionUserId

string

User ID from tracking system

user_abc

trackSysConversionSub1 – trackSysConversionSub5

string

Custom tracking parameters

sub_value_1

deviceBrand

string

Device brand

Apple

deviceModel

string

Device model

iPhone 15

deviceOs

string

Operating system version

iOS 17.4

deviceCarrier

string

Mobile carrier

Verizon

deviceCategory

string

Device category

Phone

deviceUserAgent

string

User agent string

Mozilla/5.0

deviceCountry

string

Device country

US

deviceCountryState

string

Device state/region

California

clientIp

string

Client IP address

198.51.100.1

Did this answer your question?