gokart-logo-v3
GoKart - Documentation - Offer Wall Integration
Pages
General Schemas

icon picker
Response Data

The GoKart API uses structured response models to provide consistent and meaningful feedback to API clients. These response models encapsulate common properties such as unique response IDs, success status, response titles, response types, and any associated messages. Additionally, they support the inclusion of data payloads when needed.

ResponseResult Model

The ResponseResult model serves as the base for all API responses, encapsulating common properties.

Properties

responseId (string): Unique identifier for the response, automatically generated.
isSuccessful (boolean): Indicates whether the response represents a successful operation.
responseTitle (string): Human-readable title of the response, derived from the response type.
responseType (string): Type of response, used to determine the success status and title.
messages (array of strings): List of messages associated with the response, which can include error messages or other relevant information.

Example JSON Response

{
"responseId": "442c1dfd-9039-4b1a-b94d-082c2db39ecd",
"isSuccessful": true,
"responseTitle": "Success",
"responseType": "Success",
"messages": []
}

ResponseResult with Data

The ResponseResult model includes also a typed data payload when it needed, making it versatile for various types of responses that include data.

Properties

data (object): The data payload of the response, which can be any type specified.

Example JSON Response with Data

{
"responseId": "442c1dfd-9039-4b1a-b94d-082c2db39ecd",
"isSuccessful": true,
"responseTitle": "Success",
"responseType": "Success",
"messages": [],
"data": {
"offers": {
"indexFrom": 0,
"pageIndex": 0,
"pageSize": 10,
"totalCount": 12,
"totalPages": 2,
"items": [
{
"id": "492aeffb-199a-43d1-adbf-2761c3ee5ff1",
"name": "Freeplay AOS",
"headline": "Make money from anywhere",
"shortDescription": "",
"keyPoints": "Freeplay is a rewards app that lets users earn points by completing offers and fun surveys, and exploring exclusive offers, all while redeeming their points for gift cards. It’s an easy way to turn everyday interactions into valuable rewards, making every moment on your mobile device more rewarding.<p style=\"text-align:start;\"></p>\n<p style=\"text-align:left;\"><br></p>\n<p style=\"text-align:start;\"></p>\n<p style=\"text-align:left;\"><span style=\"color: rgb(0,0,0);background-color: rgb(255,255,255);font-size: 16px;font-family: wfont_a3f637_3f0d4ffb6bdc4c1cb6dc005c9dadbf65, wf_3f0d4ffb6bdc4c1cb6dc005c9, orig_inter_regular;\">Install, Signup, and Complete your first survey or offer. </span></p>\n",
"offerDetails": "",
"termsAndDisclaimers": "<p><span style=\"color: rgb(79,85,91);background-color: rgb(255,255,255);font-size: 14px;font-family: Work Sans;\">Must be a new email registration. Any form of fraud will be rejected. </span></p>\n",
"creativeFileUrl": "https://cdn.getgokart.ai/tenants/brownboots-preprod/offers/492aeffb-199a-43d1-adbf-2761c3ee5ff1/cdee488a-fd62-4f0d-9612-700342aca7fc.png",
"categoryName": "Free",
"offerSource": "Brown Boots",
"reward": 0,
"rewardPendingDays": null,
"offerType": "MultiEvent",
"launchDate": "2025-07-07T07:00:00+00:00",
"endDate": null,
"deviceTypes": [
"Android",
"MacOS",
"Browser"
],
"advertiserId": "26aa73a4-2912-4ffa-bfc8-73be870e7f59",
"advertiserName": "Ellbee Applications",
"creatives": [
{
"order": 0,
"url": "https://cdn.getgokart.ai/tenants/brownboots-preprod/offers/492aeffb-199a-43d1-adbf-2761c3ee5ff1/cdee488a-fd62-4f0d-9612-700342aca7fc.png",
"metadata": null
}
],
"events": [
{
"offerEventId": "6ce66ca1-962f-40b5-a79e-7a70b7920fa3",
"name": "Install",
"sequenceNumber": 1,
"reward": null,
"deadlineDays": null,
"rewardPendingDays": 0
},
{
"offerEventId": "05e9abeb-a747-4652-be33-90a0b3ba845a",
"name": "Check your account",
"sequenceNumber": 3,
"reward": null,
"deadlineDays": 1,
"rewardPendingDays": 0
},
{
"offerEventId": "31068676-736c-4514-92bf-7844eb84effc",
"name": "Signup",
"sequenceNumber": 2,
"reward": null,
"deadlineDays": 1,
"rewardPendingDays": 5
}
]
}
],
"hasPreviousPage": false,
"hasNextPage": true
}
}
}

ResponseTypes Enumeration

The ResponseTypes enumeration defines the set of response types used to categorize the outcomes of operations within the application.

Enumeration Values

Success: Indicates that the operation was successful.
Failed: Indicates a general failure in the operation.
NotFoundError: Indicates that the requested resource was not found.
ValidationFailed: Indicates that validation failed for one or more of the provided parameters or inputs.
ServerError: Indicates an internal server error that prevented the operation from completing successfully.
ConflictError: Indicates a conflict with the current state of the target resource, such as duplicate entries.
UnprocessableEntity: Indicates that the server understood the request but refuses to authorize it.

Example Enumeration Usage

"responseType": "Success"
"responseType": "Failed"
"responseType": "NotFoundError"

Want to print your doc?
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.