Transaction Lookup

The donations API provides several methods to retrieve information about previously submitted transactions.

API Authentication

The following API methods all require standard API authentication headers as described in the main donations API documentation.


Request information about a specific transaction. A transaction Id is provided as an input parameter and the result is the information about the associated transaction. Only transactions which were originally submitted by the authenticated API key can be looked up. A transaction Id which does not exist or that was not created by the requesting user will result in identical 404 failure responses.

GET Input Values

GET Response Values

The possible response fields closely mirror those input from the /donation/creditcard method. Not all possible fields may be returned. E.g., fields which weren’t provided in the original donation request or sensitive credit card information (the FirstGiving donations API never stores client card data). Responses also include fields with information about disbursement (status, paymentStatus, postingDate) and the breakdown of fees for the transaction (commissionFees, ccFees, totalFees, netToOrganization). If the transaction has not been completely processed, these fields may contain a simple string value of ‘FG_UNAVAILABLE’.

<?xml version="1.0" encoding="UTF-8"?>
   <billToAddressLine1>1 Main St.</billToAddressLine1>


It is also possible to get a list of all transaction Id’s.

<?xml version="1.0" encoding="UTF-8"?>

A maximum of 100 transaction Id’s at a time will ever be returned by this method. If the application has more transactions than this, there is a pagination feature which can be used to return the other transaction Id’s.

Get Input Values

Example /transaction/list with ‘count=on’:


<?xml version="1.0" encoding="UTF-8"?>
FrontStream Holdings LLC is a registered ISO of Elavon, Inc. Georgia, Chase Paymentech Solutions, LLC, First National Bank of Omaha, Omaha, NE, BMO Harris Bank, N.A., Chicago, IL, Deutsche Bank, USA, New York, NY and Wells Fargo Bank, N.A., Walnut Creek, CA.