These are objects representing the transactions generated by the Advertiser. A list of transactions is returned.

Specifications

  • Path: /api/v1/transactions

  • HTTP verb: GET

Parameters

  • limit
    A limit on the number of objects to be returned. Accepts integers between 1 and 50. If not specified the default value is 10.

  • offset
    An offset for use in pagination. It offsets the starting point of the returned objects by the provided integer. For instance, if you request a list of the first ten objects, your subsequent call can include offset=10 in order to fetch the next 10 objects.

  • currency
    The currency in which the transactions are returned. Affects the values of the fields payout and transactionAmount. Accepts three-letter currency codes specified by the ISO-4217 standard. If not specified the default value is eur.

  • sort
    The field on which the returned objects are sorted before the limit and offset values are applied. Accepts adInventory adInventorySid offer offerSid, country productGroup transactionID transactionAmount payout saved and clickSaved as valid values. If not specified the default value is saved.

  • sortDir
    The direction in which the response is sorted before the limit and offset values are applied. If not specified the default value is desc.

  • savedFrom
    Filter the returned transactions on the minimum saved date. The provided date is included in the range. Accepts date values in the format yyyy-mm-dd.

  • savedTo
    Filter the returned transactions on the maximum saved date. The provided date is not included in the range. Accepts date values in the format yyyy-mm-dd.

  • offerSid
    Filter the returned transactions on the offer.

  • adInventorySid
    Filter the returned transactions on the Ad inventory.

  • country
    Filter the returned transactions on the country. Accepts two-letter country codes specified by the ISO 3166-1 Alpha-2 standard. Multiple values can be separated with a comma.

  • type
    Filter the returned transactions on their type. Accepts integers from 1 to 5. See definitions for complete reference. Multiple values can be separated with a comma.

  • status
    Filter the returned transactions on their status. Accepts integers from 1 to 7. See definitions for complete reference. Multiple values can be separated with a comma.

Example response

[
    {
        "status" : "approved",
        "provider" : "Target Circle",
        "providerSid" : "tgtccl",
        "publisher" : "Test Account TC Publisher",
        "publisherSid" : "cf78d2",
        "adInventory" : "TC Test Ad Inventory",
        "adInventorySid" : "a8gh3x",
        "offer" : "TC Test Offer",
        "offerSid" : "wsu7nr",
        "country" : "DE",
        "device_group" : "Android 6 and higher",
        "device_type" : "mobile",
        "device_brand" : "Samsung",
        "device_model" : "SM-J330",
        "device_os" : "Android",
        "device_os_version" : "6.1",
        "device_carrier" : "Vodafone",
        "device_connection_type" : "Cellular",
        "transactionType" : "lead",
        "productGroup" : "electronics",
        "priceSegment" : "silver",
        "transactionId" : "800735BF",
        "trackingMethod" : "local_cookie",
        "currency" : "EUR",
        "transactionAmount" : "70.35000",
        "commission" : "2.00000",
        "payout" : "1.85000",
        "saved" : "2016-10-23 15:07:34",
        "validationDate" : "2016-11-06 08:56:47",
        "clickSaved" : "2016-10-17 14:07:17",
        "clickToConversionTime" : "522017",
        "IP" : "212.71.94.109",
        "referrer" : "www.facebook.com"
        "sourceId" : null,
        "gaid" : null,
        "idfa" : null,
        "waid" : null,
        "slug" : "57aea1a7-6d74-4396-9c03-2d298e4a431a"
    }
]

Response codes

  • 200 Accepted

  • 401 Unauthorized – No valid account token

  • 408 Request timeout – Request Time Out

Boost your affiliate program

Download our free whitepaper for insights into 2020’s top affiliate marketing trend: self-service affiliate programs

© 2020 Target Circle AS | Terms & Privacy | Cookie preferences | Email

Learn the 2020’s Top Affiliate Marketing Trends