Skip to main content

GET Conversions List

Returns a paginated list of conversion records across offers

Written by GoKart Support

Endpoint

GET /api/v1/sdk-conversion-system/conversions

This endpoint returns a paginated and filterable list of conversion records for the account. 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.


Sorting & Pagination

Name

Type

Example

Description

page

integer

?page=0 (first page)
?page=1 (second page)

Specifies which page of results to retrieve. Should be zero or positive integers.

page_size

integer

page_size=10

Defines the number of results returned per page. Must be a positive integer between 1–100. Default: 10

orderby

string

orderby=CreatedAt

Field used for sorting. Default: CreatedAt

order_asc

Boolean

order_asc=false

Sort direction. Default: false


Filtering

Name

Example

Available Values / Notes

Required

user_completed_at_from

2026-01-01T00:00:00Z

Start of date range (ISO 8601). If not provided, API will return no results

Yes

user_completed_at_to

2026-03-31T23:59:59Z

End of date range (max span: 3 months).

If not provided, API will return no results

Yes

search

filter.search=my+offer

Free-text search across conversions

No

searchBy

searchBy=PubMemberId,OfferName

Comma-separated fields to search within

No

offer_type

filter.offer_type=SingleEvent

SingleEvent, MultiEvent

No

tracking_system

filter.tracking_system=AppsFlyer

AppsFlyer, Singular, Impact, Adjust, CJAffiliate, TUNE, CAKE, Everflow, PerformCB, MAF, Lootably, Sharesale, AdAction, AdGateMedia, RevenueUniverse, HangMyAds, Torox, AyeTstudios, Besitos, Rakuten, AdGateReward, AdJoe, AdMantum, AdscendMedia, AdworkMedia, Bitlabs, Cpalead, JustTrack, KashKick, Kiwiwall, MyChips, Notik, Personaly, RevenueHut, Tapjoy, Tenjin, TimeWall, Wannads, Branch, Kochava, CustomTracking, AWIN, AppSamurai, GoKart

No

offer_source

filter.offer_source=GoKart

GoKart, RevenueUniverse, CustomIntegration, Wannads

No

device_types

filter.device_types=IOS,Android

IOS, Android, MacOS, Browser, All

No

advertiser_ids

advertiser_ids=guid1,guid2

Comma-separated GUIDs

No

placement_ids

placement_ids=guid1

Comma-separated GUIDs

No

partner_ids

partner_ids=guid1

Comma-separated GUIDs

No

partner_names

partner_names=PartnerA,PartnerB

Comma-separated names

No

offer_ids

offer_ids=guid1,guid2

Comma-separated GUIDs

No

offer_names

offer_names=My+Offer

Comma-separated names

No

conversion_statuses

conversion_statuses=Pending,Success

Pending, Success, Rejected, InProgress, Completed

No

exclude_zero_revenue

exclude_zero_revenue=true

Excludes conversions with 0 revenue

No

exclude_zero_payout

exclude_zero_payout=true

Excludes conversions with 0 payout

No


Response Overview

  • Returns the general response schema here

Default Response Fields

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?