2007

Table Of Contents
Name-Value Pair API Developer Guide and Reference April 2007 51
NVP API Method and Field Reference
TransactionSearch
TransactionSearch returns up to 100 matches. Partial matches are displayed. For example,
setting the TransactionSearchRequest FirstName to “Jess” returns results such as
“Jessica” and “Jesse”.
The most important returned element is TransactionID, which you can pass to
GetTransactionDetails in order to retrieve all available information about a specific
transaction.
TABLE A.12 TransactionSearch Request Parameters
Parameter Description Required
METHOD Name of API call: TransactionSearch Yes
STARTDATE The earliest transaction date at which to start the search.
NOTE: No wildcards are allowed. The value must be in UTC/GMT
format.
Yes
ENDDATE The latest transaction date to be included in the search No
EMAIL Search by the buyers email address
Character length and limitations: 127 single-byte alphanumeric characters
No
RECEIVER Search by the receivers email address. If the merchant account has only
one email, this is the primary email. Can also be a non-primary email.
No
RECEIPTID Search by the PayPal Account Optional receipt ID No
TRANSACTIONID Search by the transaction ID.
NOTE: The returned results are from the merchant’s transaction records.
Character length and limitations: 19 single-byte characters maximum
No
INVNUM Search by invoice identification key, as set by you for the original
transaction. This field searches the records for items sold by the merchant,
not the items purchased.
NOTE: No wildcards are allowed.
Character length and limitations: 127 single-byte characters maximum
No
ACCT Search by credit card number, as set by you for the original transaction.
This field searches the records for items sold by the merchant, not the
items purchased.
NOTE: No wildcards are allowed.
Character length and limitations: Must be at least 11 and no more than 25
single-byte numeric characters maximum. Special punctuation, such as
dashes or spaces, is ignored.
No
SALUTATION Buyers salutation
Character length and limitations: 20 single-byte characters
No
FIRSTNAME Buyers first name
Character length and limitations: 25 single-byte characters
No