---
title: "Get List of Transactions"
slug: "returns-a-list-of-transactions-for-a-given-advertiser"
updated: 2025-10-07T13:04:03Z
published: 2025-10-07T13:04:03Z
canonical: "help.awin.com/returns-a-list-of-transactions-for-a-given-advertiser"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.awin.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get List of Transactions

Get/advertisers/{advertiserId}/transactions/

		
			

**GET transactions (list)**

Advertisers can pull individual transactions, check the status of the transactions, create their reports, and obtain additional information that can be shared between publishers and advertisers via clickref (from publisher to advertiser) and orderRef and custom parameters (from advertiser to publisher).

**Who can use it**

Advertisers

		
		

Header parametersAuthorizationstring

accessToken

Path parametersadvertiserIdinteger (int64) Required

advertiser id

Default123456

Query parametersaccessTokenstringRequired

access token

dateTypestring

date type, if not set - 'transaction' is the default

Valid values[
  "transaction",
  "validation",
  "amendment"
]Default"transaction"
endDatestring (date-time) Required

end date

Default"2021-03-15T01:59:59Z"
publisherIdstring

publisher id

showBasketProductsboolean

show basket products

Defaultfalse
startDatestring (date-time) Required

start date

Default"2021-01-01T00:00:00Z"
statusstring

transaction status

Valid values[
  "pending",
  "approved",
  "declined",
  "deleted"
]
timezonestring

time zone in short or default format

Default"UTC"

		
			

**Further details on query parameters**

| parameter | format | mandatory/optional |
| --- | --- | --- |
| startDate | yyyy-MM-ddThh:mm:ss | mandatory |
| endDate | yyyy-MM-ddThh:mm:ss | mandatory |
| dateType | transaction validation amendment | optional (falls back to "transaction" if not set) |
| timezone | Europe/Berlin Europe/Paris Europe/London Europe/Dublin Canada/Eastern Canada/Central Canada/Mountain Canada/Pacific US/Eastern US/Central US/Mountain US/Pacific UTC | mandatory |
| publisherId | 12345 or 12345,67890 for multiple ones | optional, available for advertisers |
| advertiserId | 12345 or 12345,67890 for multiple ones | optional, available for publishers |
| status | pending approved declined deleted | optional |
| showBasketProducts | JSON array | optional |

		
		

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='8f36fa3d-e41b-43a2-8935-b2d11d5f56e2'>application/json;charset=UTF-8</option>
</select>

		
			

Note that the field "lapseTime" is the conversion time in seconds

**Basket Products**

If &showBasketProducts=true then products sent via Product Level Tracking matched to the transaction can be viewed (please see "Conditional data fields" below for restrictions that might apply)

**Conditional data fields**

Some data fields are available for advertisers depending on additional settings.

| datafield | available for advertisers |
| --- | --- |
| orderRef | yes |
| clickRef | yes |
| clickRef2 - clickRef6 | no |
| customParameters | yes |
| basketProducts | yes |
| networkFee | yes, if the advertiser has standard invoicing terms |

**Response values for "type"**

Sale, Lead, Bonus, 2nd Tier, Commission group transaction, PPC, TQS, Mobile Sale, Mobile Lead, Mobile App Install, Mobile App Purchase, Compensation,