List offers

Developing

GET

https://api.targetcircle.com/api/v2/publisher/offers

Using this endpoint you can list offers that are connected to your ad inventories.

Request

Authorization

API Key

Add parameter in header

X-Api-Token

Example:

X-Api-Token: ********************

Query Params

Responses

🟢200Success

application/json

Bodyapplication/json

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.targetcircle.com/api/v2/publisher/offers?adInventorySid=undefined&sid=undefined&name=undefined&offset=undefined&limit=undefined&provider=undefined&advertiser=undefined&offerStatus=1&country=undefined&category=31&vertical=1&vertical_exclude=1&offerSalesManager=undefined&salesManager=undefined&fallbackCurrency=undefined&attributionModel=undefined' \
--header 'X-Api-Token: <api-key>'

Response Example

{
    "data": [
        {
            "sid": "abc123",
            "name": "string",
            "description": "string",
            "logo": {
                "url": "string",
                "mimeType": "image/jpeg"
            },
            "defaultTargetUrl": "string",
            "tracking": {
                "deeplinking": true,
                "cookieExpiration": 2592000,
                "fingerprintExpiration": 2592000,
                "impressionExpiration": 86400
            },
            "vertical": {
                "id": 0,
                "name": "string"
            },
            "category": {
                "id": 0,
                "name": "string"
            },
            "targetedCountries": [
                "string"
            ],
            "provider": {
                "sid": "string",
                "name": "string"
            },
            "advertiser": {
                "sid": "string",
                "name": "string"
            },
            "connectedAdInventories": [
                {
                    "adInventory": {
                        "sid": "string",
                        "name": "string"
                    },
                    "issuedAt": "2019-08-24T14:15:22.123Z",
                    "defaultClickTrackingUrl": "string",
                    "priceCombinations": [
                        {
                            "transactionType": "sale",
                            "productGroup": {
                                "sid": "abc123",
                                "name": "Electronics"
                            },
                            "countries": [
                                "string"
                            ],
                            "payout": {
                                "type": "fixed",
                                "value": 9.5,
                                "currency": "EUR"
                            }
                        }
                    ]
                }
            ]
        }
    ],
    "next": "string",
    "prev": "string"
}

Modified at 2026-03-12 11:57:51

List vouchers

Voucher