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