iGolder API: <GetSubAccountTransactionHistory>

 

Downloading my transaction history

With iGolder, you can download the transactions history of any of your sub-accounts.  Downloading your transaction history may be useful if you want to perform additional processing regarding your transactions, such as reconciling your iGolder transactions with your accounting software.  Our web service API to also enables you to search your transaction history.  For instance, you may search a transaction by date or by amount, and iGolder will return you a list of transactions matching your search criteria.

 

Requested Value Description
DateFrom Optional parameter to return transactions from a specific date and time.  For instance, if you are only interested about last week's transactions, then you specify the date of the previous week.  By specifying a date range, you make your automation faster and iGolder more responsive to your requests.
DateUntil Optional parameter to return transactions older than a specific date and time.
If you know the exact date of a transaction, simply set the DateFrom and DateUntil to the same value, and iGolder will return all transactions on that day.  The date may include the time of the day, such as 2009-02-14 @ 14:39:18.  If the time is not specified, then iGolder will assume the full day.
AmountFrom /
AmountTo
Optional parameters to return transactions within the amount range.  This parameter is very useful when searching a transaction you know the amount.
Email (NYI) Optional parameter to return transactions matching an email address.  You may specify a wildcard such as * or ?
Name (NYI) Optional parameter to return transactions matching the name of a customer.  You may specify a wildcard such as * or ?
Note (NYI) Optional parameters to return transactions containing a keyword in the description note.
TransactionId (NYI) Optional parameter to return the transaction matching a transaction identifier.
TransactionType

Optional parameter to return transactions of a given type, such as payments sent, payments received, payments refunded and payments in dispute:

  • PaymentsSent: Return all transaction where you initiated the payment (you sent gold to someone).
  • PaymentsReceived: Return all transactions where you received gold from a customer.  Such transactions include payments which are still in Safetransit™ as well as refunded payments.
  • SubAccountTransfer: Return all transactions involving a transfer with another sub-account.
TransactionStatus
  • PaymentsPendingInSafetransit: Return only transactions still in Safetransit, waiting for the gold to clear in your account.  If you made a payment to a customer and the gold is still in Safetransit, then the payment will be listed as PaymentsSent.
  • PaymentsRefunded: Return all transactions you provided any refund to your customer.  The refund may be a partial or a full refund.
  • PaymentsInDispute: Return all transactions currently in dispute.  A transaction in dispute may have been initiated by you or by your customer.
  • PaymentCompleted: The payment is complete.
Filter
  • Sent: Only payments sent
  • Received: Only payments received
  • Transfers: Only transfers between sub-accounts
  • Safetransit: Only the payments in Safetransit
  • Refunded: Only payments refunded
  • Dispute: Only the payments in dispute

 

<GetSubAccountTransactionHistory> <SubAccountId>16523c7d4fc44925a6a844fb919ea8b9</SubAccountId> <SecurityTokenId>0498d220267241f2a8106b416df1ed33</SecurityTokenId> <DateFrom>2009-02-14</DateFrom> <!-- [Optional] Return all transactions from a specified date --> <DateUntil>2050-12-31</DateUntil> <!-- [Optional] Return all transaction until a specified date --> <AmountFrom>0</AmountFrom> <!-- [Optional] Return all transactions larger or equal to a quantity of gold --> <AmountTo>999999</AmountTo> <!-- [Optional] Return all transactions smaller or equal to a quantity of gold --> </GetSubAccountTransactionHistory>

After invoking the web service https://www.iGolder.com/api.ashx, iGolder will return you a list of transactions matching your search criteria.  For performance, iGolder will return the first 1000 transactions matching your query.  If you need to fetch more than 1000 transactions, then you must split your search request into multiple queries by specifying a date range <DateFrom> and <DateUnill>.

<SubAccountTransactionHistory> <Transaction> <ReceiptId>61a2e41a08d6436c81c405e22ee2a750</ReceiptId> <Date>2009-02-04 06:54:53</Date> <Amount>-5.900</Amount> <Fee>0.000</Fee> <Payer>User2@igolder.com</Payer> <Payee>User1@igolder.com</Payee> <ClosingBalance>178.632</ClosingBalance> <Transfer> <TransferId>61a2e41a08d6436c81c405e22ee2a750</TransferId> <TransferType>Gold Payment</TransferType> <Payer>User2@igolder.com</Payer> <Payee>User1@igolder.com</Payee> <CurrencyId>Grams of Gold</CurrencyId> <Amount>-5.900</Amount> <Memo>Consectetuer tempor placerat invidunt takimata dolor nonumy dolore tincidunt diam.</Memo> </Transfer> </Transaction> <Transaction> ... </Transaction> </SubAccountTransactionHistory>

Returned Value Description
ReceiptId
and
TransactionId
Unique identifier for the transaction.  This value is always a GUID.
Date Transaction date, formatted in your timezone.  If the time is incorrect, please configure your timezone in the account settings.
Amount Transaction amount, in grams of gold.  The amount is positive if you received a gold payment, and the amount is negative when sending gold to someone else.
The transaction amount always includes the transfer fee.
Fee Transaction Fee, in grams of gold, when receiving a gold payment.  The transaction fee is always zero when sending gold to someone else.
Payer The email of the sender, if the email is not provided this field contain the account name.
Payee Email or Alias of the recipient of gold.
ClosingBalance Your sub-account balance, in grams of gold, after executing the transaction.  This amount is the total balance in your sub-account, including any gold in Safetransit.
CurrencyId Always Grams of Gold.  That value is there for compatibility only.
TransferType Type of transfer can be one of the following value:
  • Gold Payment: when you sent gold to someone else.
  • Gold Received: when you received gold from someone else.
  • Sub-Account Transfer: when you transfer gold to another sub-account.
  • Refund: The payment was refunded.
Memo The description of the transaction.  You may change the transaction description online in the transaction details.

 

Date,Id,Type,Status,From,IdFrom,To,IdTo,AmountGr,FeeGr,AmountOz,AmountUSD,AmountEUR,AmountGBP,AmountCAD,AmountNZD,Description

 

The maximum number of transactions that can be returned from a GetSubAccountTransactionHistory API call is 1000.

 

Untitled 1 This is a test for documenting <Transaction>  

 

Since August 1st, 2013 iGolder is no longer accepting new accounts and balances can only be redeemed. During the past years, we have been recommending Bitcoin more than our own payment system. We believe in physical gold ownership, and developed iGolder as a mechanism for people to acquire physical gold by trading with one another.

Since iGolder has a central point of failure (our server may be raided by thugs wearing some kind of uniform), we feet it is safer for us to cease operations. The iGolder experiment has been personally rewarding as we met many gold enthusiasts and also learned about Bitcoin in the process. For those who have no idea what Bitcoin is, we recommend doing your own research. Bitcoin is far superior to iGolder in every way, both in privacy and security as our server is always vulnerable to confiscation. Bitcoin is a communication protocol with a built-in "escrow service" capable of protecting both the buyer and the seller, rendering our Safetransit completely redundant. To learn more about the Bitcoin protocol and its feature, please watch "http://www.youtube.com/watch?v=mD4L7xDNCmA (Bitcoin 2012 London: Mike Hearn).

For those having gold in their iGolder account, we will ship the physical metal to anyone having more than 1 ounce of gold, assuming the owner is willing to assume the shipping costs. For smaller quantities, we offer to settle in Bitcoin, however we will also settle with any other reasonable payment system. We will give everyone at least two full years (until 2016) to contact us to claim their gold. After that period, any unclaimed gold will go to fund an economic development project in Honduras helping local people to become entrepreneurs.

We sincerely wish you the best in life and hope to keep in contact with you.

Yours in liberty,
The iGolder Team.


Update 2014: Since we announced we no longer accept gold transfers, we have received countless emails asking to keep the free gold charts and the PGP encryption tools. We plan to keep running the domain iGolder.com for both the gold charts and the encryption tools. Better, we are developing state of the art open-source software for a secure decentralized social network with a built-in wallet. We will announce when we have a product ready for use. Stay tuned!