Partner - GET Offers List | GoKart Help Center

Endpoint

GET /api/v1/sdk-offer-management/partner

This endpoint is intended for external partners/publishers of an affiliate network or advertiser to programmatically retrieve the same offer inventory available within the Partner Portal.

If an affiliate network is sharing offers with you through the partner dashboard, this endpoint allows you to fetch the complete list of available offers through an API.

This enables partners/publishers to sync campaigns, build custom integrations, automate offer management workflows, or display offer data within their own systems.

Authentication

All requests must include a Partner API token in the Authorization header, which GoKart uses to identify your integration system.

Request Header:

Authorization: ApiToken {your-token}

Replace {your-token} with the actual token provided by GoKart.

Follow these instructions to generate your Partner API Key.

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
`search`	`filter.search=my+offer`
`offer_type`	`filter.offer_type=SingleEvent`	SingleEvent, MultiEvent

Response Overview

Returns a paginated list of offer objects

Returns the general response schema here

Default Response Fields

Field	Type	Example	Description
`id`	string (UUID)	`3eb57088-361f-4b34-9a62-686df8f5506a`	Unique offer identifier
`categories`	array	`["Banking"]`	Categories assigned to the offer
`name`	string	`Coin Master`	Name of the offer (display title).
`budgetAmount`	number	`200`	Budget amount allocated for the offer
`launchDate`	datetime	`2026-03-03T22:00:00+00:00`	Date the offer was launched.
`endDate`	datetime / null	`null`	Date the offer expires.
`offerType`	string	`MultiEvent`	Type of offer (`SingleEvent`, `MultiEvent`)

Example

Request:

GET https://api.[YOUR_TENANT].getgokart.ai/api/v1/sdk-offer-management/partner

Replace [YOUR_TENANT] with the domain of the advertiser or affiliate network.

The tenant name is the same domain used in the partner portal URL provided to you.

For example, if your partner portal URL is:

https://app.affiliate123.getgokart.ai/

then your API request would use:

https://api.affiliate123.getgokart.ai/api/v1/sdk-offer-management/partner

Response:

{
   "data": {
     "pageIndex": 0,
     "pageSize": 10,
     "totalCount": 8,
     "totalPages": 1,
     "indexFrom": 0,
     "items": [
       {
         "id": "3eb57088-361f-4b34-9a62-686df8f5506a",
         "categories": [
           "Banking"
         ],
         "name": "Andrii Test Mar 6",
         "budgetAmount": 23,
         "launchDate": "2026-03-03T22:00:00+00:00",
         "endDate": null,
         "offerType": "MultiEvent"
       }
     ],
     "hasPreviousPage": false,
     "hasNextPage": false
   },
   "responseId": "91fe4057-b9e5-4cc1-ab63-3bc22cf596c8",
   "isSuccessful": true,
   "responseTitle": "Success",
   "responseType": "Success",
   "messages": []
}

SdkOfferWall - GET Offers

GET Offers List

GET Conversions List

Partner - GET Offer Details

Publisher Exchange Offers Feed