Download Account History

DOCS

Last updated: Sept 19th, 1:45am

Important: NVP/SOAP is a legacy integration method. We accept new integrations and support existing integrations, but there are newer solutions. If you're starting an integration, we recommend our latest solutions.

You can download transaction history logs from https://www.paypal.com.

You can also choose the type of file, the date range, and select which fields you would like included in the history file.

Download Steps

Log into your PayPal business account.

Navigate to the Download History page by choosing Activity at the top of the page, and then clicking Download on the right side of the Activity page.

Note: If you do not see an Activity link at the top of the page, click History, which appears in the top menu when the My Account tab is selected, and then select Download History from the History menu.

Click on the Customize Download Fields link on the right to open the Customize My History Download page. On this page, you can select the fields you would like included in the download.

Click Save to save any changes you make to this page, or Cancel to return to the Download History page.

On the Download History page, select the date range and the desired file type as well as other options.

Click the Download History button to open or save the file containing the requested history.

Download History Fields

The following table includes an alphabetical list of some of the downloadable history fields, a description of each field, typical field format, and any related payment button fields or IPN fields.

Note: IPN or Instant Payment Notification is PayPal's transaction notification service. For more information see IPN Intro.

Fields and Values in Downloadable History Logs
Field	Description	Format	Payment button Variable	Related IPN variable
Address Status	Status of counterparty's shipping address. Value is confirmed or non-confirmed.	Up to 14 alphanumeric characters		`address_status`
Auction Site	Name of auction site: eBay Yahoo! Auctions uBid.com Amazon.com Auctions MSN Auctions BidVille Other	Up to 20 alphanumeric characters
Balance	Account balance at time of transaction. Balance is reported in the currency of the transaction. The Balance column can show `...` in some instances, which indicates that showing a balance is not appropriate for these kinds of transaction.	Signed decimal
Balance Impact	Effect of the transaction on the account balance.
Buyer ID	Unique PayPal customer account identification number.
Closing Date	Close date of eBay/Auction Item (eBay/Auction-specific)	`[M]M/[D]D/YYYY`
Contact Phone Number	Telephone number of the payer.
Counter Party Status	Account status of buyer: International – Unverified International – Verified Unverified Verified	Up to 27 alphanumeric characters		`payer_status`
Currency	Currency of transaction	Up to three alphanumeric characters	`currency_code`	`mc_currency` `settle_currency` `exchange_rate` `mc_gross`
Custom Number	Specified by seller in any of the following button-creation fields: PayPal Shopping Cart Custom Number Buy Now Custom Number Subscription Custom Number	Alphanumeric	`custom`	`custom`
Date	Date transaction was initiated (according to PayPal system time, US-Pacific time zone). Log sorted in reverse chronological order by Date (most recent first).	`[M]M/[D]D/YYYY`		`payment_date` `subscr_date`
Fee	Fee (if applicable) for transaction	Signed decimal		`payment_fee` `mc_fee`
From Email Address	Email address of transaction sender	Up to 128 alphanumeric characters		`payer_email`
Gross	Gross amount of transaction	Signed decimal	`amount`	`payment_gross` `settle_amount` `amount1` `amount2` `amount3`
Insurance Amount	Specified by buyer in the website field: eBay/Auction Insurance amount	Unsigned decimal
Invoice Number	Specified by seller in any of the following button-creation fields: PayPal Shopping Cart Invoice Number Buy Now Invoice Number Subscription Invoice Number	Alphanumeric	`invoice`	`invoice`
Item ID	Specified by buyer in the website field: Auction/Item Number Or by seller in any of the following button-creation fields: PayPal Shopping Cart Item Number Buy Now ID Number Donations ID Number Subscription Reference Number	Up to 256 alphanumeric characters	`item_number`	`item_number`
Item Title	Specified by buyer in the website field: Auction/Item Title Or by seller in any of the following button-creation fields: PayPal Shopping Cart Item Name Buy Now Item Name Donations Item Name Subscriptions Name	Up to 128 alphanumeric characters	`item_name`	`item_name`
Item URL	URL of eBay/Auction Item (eBay/Auction-specific)	Up to 256 alphanumeric characters
Multi-Column Shipping Address	Address displays in separate columns. First line of shipping address as specified by counterparty.	Up to 395 alphanumeric characters		`address_street1`
	Second line of shipping address as specified by counterparty (if applicable)	Up to 395 alphanumeric characters		`address_street2`
	Town or city of shipping address as specified by counterparty	Alphanumeric		`address_city`
	State, Province, Region, Territory, Prefecture or Republic of shipping address as specified by counterparty			`address_state`
	Zip or postal code of shipping address as specified by counterparty			`address_zip`
	Country of shipping address as specified by counterparty			`address_country`
Name	Name of counterparty. If counterparty is a PayPal verified user, this field will contain the user's first and last name. If counterparty is not a verified user, field will contain the user's email address.	Up to 128 alphanumeric characters	`first_name` `last_name`
Net	Net amount of transaction	Signed decimal
Note	Note for transaction as entered by counterparty	Up to 2000 alphanumeric characters
Option Names and Values	Names: Specified by seller in any of the following button-creation fields: PayPal Shopping Cart Option 1[2] Name Buy Now Option 1[2] Name Subscription Option 1[2] Name	Up to 60 alphanumeric characters	`on0` `on1`	`option_name1` `option_selection1`
	Values: Entered by buyer in any of the following website fields: PayPal Shopping Cart Option 1[2] Value Buy Now Option 1[2] Value Subscription Option 1[2] Value Or specified by seller in any of the following button-creation fields: PayPal Shopping Cart Value 1[2] Choices Buy Now Value 1[2] Choices Subscription Value 1[2] Choices	Up to 30 alphanumeric characters	`on1` `os1`	`option_name2` `option_selection2`
Payment Type	Payment type used for transaction: eCheck Instant PayPal Funds	Up to 27 alphanumeric characters		`payment_type`
Receipt ID	PayPal Account Optional receipt ID	16 digits in `xxxx-xxxx-xxxx-xxxx` format		`receipt_id`
Reference Txn ID	Transaction ID of parent transaction	Up to 17 alphanumeric characters
Sales Tax	Sales Tax Amount specified in seller’s button-creation process and Profile preferences	Unsigned decimal	`tax`
Shipping Amount	Specified by buyer in the website field: eBay/Auction Shipping amount Or by seller in any of the following button-creation fields: PayPal Shopping Cart Shipping amount Buy Now Shipping amount	Unsigned decimal	`shipping` `shipping2` `handling`
Single Column Shipping Address	Address displays in a single column. First line of shipping address as specified by counterparty.	Up to 395 alphanumeric characters		`address_street1`
	Second line of shipping address as specified by counterparty (if applicable)	Up to 395 alphanumeric characters		`address_street2`
	Town or city of shipping address as specified by counterparty	Alphanumeric		`address_city`
	State, Province, Region, Territory, Prefecture or Republic of shipping address as specified by counterparty			`address_state`
	Zip or postal code of shipping address as specified by counterparty			`address_zip`
	Country of shipping address as specified by counterparty			`address_country`
Status	Status of transaction at time of download: Canceled Cleared Completed Denied Expired Failed Pending Refunded Returned Reversed Unclaimed Uncleared	Up to 10 alphanumeric characters		`payment_status` `pending_reason`
Subject	Subject of transaction as entered by counterparty	Up to 256 alphanumeric characters
Subscription Number	PayPal-generated Subscription Transaction ID Number `S-xxxxxxxxxxxxxxxx` Where x is the transaction ID.	Up to 19 alphanumeric characters		`subscr_id`
Time	Time transaction was initiated (according to PayPal system time, US-Pacific time zone).	`HH:MM:SS`
Timezone	The time zone used for recording transactions in your PayPal account.	Up to three alphanumeric characters
To Email Address	Email address of transaction recipient	Up to 128 alphanumeric characters	`business`	`receiver_email`
Transaction ID	PayPal-generated unique transaction ID	Up to 17 alphanumeric characters		`txn_id`
Type	Type of transaction: Add Funds from a Bank Account ATM Withdrawal ATM Withdrawal Reversal Auction Payment Received Auction Payment Sent Canceled Fee Canceled Payment Canceled Transfer Chargeback Settlement Check Withdrawal from PayPal Currency Conversion Debit Card Cash Advance Debit Card Purchase Dividend From PayPal Money Market Donation Received Donation Sent eCheck Received eCheck Sent Funds Added with a Personal Check Guarantee Reimbursement Payment Received Payment Sent PayPal PayPal Balance Adjustment Referral Bonus Refund Shopping Cart Item Shopping Cart Payment Received Shopping Cart Payment Sent Subscription Payment Received Subscription Payment Sent Transfer Update to Add Funds from a Bank Account Update to Debit Card Credit Update to eCheck Received Update to Payment Received Update to Payment Sent Update to Reversal Update to Web Accept Payment Received Virtual Debit Card Authorization Virtual Debit Card Credit Received Virtual Debit Card Purchase Virtual Debt Card Credit Received Web Accept Payment Received Web Accept Payment Sent Withdraw Funds to a Bank Account	Up to 39 alphanumeric characters		`txn_type`