Retrieving the Transactions for a Specific Seller  

To retrieve the transaction data for a specified seller, use GetSellerTransactions. Doing this involves three general steps: setting up the execution environment, specifying the item transactions to return (based on the seller's), and making the API call.

When executing GetSellerTransactions, the user can only request their own transaction data. That is, an eBay user cannot use this call to retrieve another seller's list of transaction data. This means it is not necessary (or even possible) to specify a particular seller in the request payload. Instead, eBay uses the security credentials (see Security) to determine whose transaction data to return.

This call can potentially return a very large number of transactions, so for each seller, use a time filter to limit the volume of the response to a particular window (range) of time. You need to execute the call at set intervals to retrieve updates on any transactions that are new or have changed status since the last time you executed GetSellerTransactions. Please see below and see the following topic: GetSellerTransactions.

If you use the NumberOfDays time filter, the eBay database is queried to determine when transactions were last modified. Note that the modification status is updated each time the Checkout status of an item changes. The Checkout status can change any time (i.e., in seconds, minutes, or days) after the transaction is created. See Working with Checkout for more information about Checkout.

Some transactions are processed with back-end batch jobs. This means there can be a short delay between an end time of an item and the recording of the initial transaction entry in the eBay database. Therefore, to make sure you do not miss any transactions, you should add time buffers, even if they are only a few seconds in length. Better yet, use the current date as the most recent date in the range to make sure you have captured all possible transactions and any updates. For each item, use the call at set intervals to get updates on any transactions that are new or have changed status since the last time you executed the call.

Depending on the window of time you specify, the call can still return hundreds of transactions. Therefore, it is recommended that you configure the request to get one page of data at a time (where each page contains a more manageable number of transactions). Pagination breaks up the total data set into smaller chunks. For more information, see the pagination information in the following topic: Retrieving the Transactions for a Single Item.

GetSellerTransactions returns a list of the transactions spawned by sales of items listed by the seller who inivoked the call. This list is contained in the TransactionArray property of the GetSellerTransactions response.

There is one TransactionType object for each transaction spawned for the seller so far and meeting the input filtering criteria. Also returned are indicators of how many transactions are returned and whether there are other transactions that could be returned (additional transactions meeting the criteria that require additional calls to retrieve). The result set also contains the page number for the data returned, the number of transactions being returned per page, and the total number of pages of transactions meeting the selection criteria. In addition, it returns information about the seller whose data was retrieved.

User-Contributed Notes