The GetAccountBalance operation retrieves the amount of money your Amazon Mechanical Turk account, as well as the amount of money "on hold" pending the completion of transfers from your bank account to your Amazon account.
The following example of a call to the GetAccountBalance operation retrieves the Requester's account balance.
http://mechanicalturk.amazonaws.com/onca/xml?Service=AWSMechanicalTurkRequester &AWSAccessKeyId=[the Requester's Access Key ID]&Version=2006-08-23 &Operation=GetAccountBalance &Signature=[signature for this request]&Timestamp=[your system's local time]
A request to the Mechanical Turk Service includes parameters that control its behavior and the data it returns. Required parameters must be included for the request to succeed.
GetAccountBalance accepts parameters common to all operations. Some common parameters are required. See Common Parameters for more information.
The following parameters are specific to the GetAccountBalance operation:
| Name | Description | Type | Value |
|---|---|---|---|
Operation
|
The operation to call. To access the
| Required |
|
A successful request for the GetAccountBalance operation will have a GetAccountBalanceResult element in the response.
The GetAccountBalanceResult element contains the following elements:
| Name | Description | Value |
|---|---|---|
AvailableBalance |
Your current Amazon Mechanical Turk account balance. The value is a Price data structure. For more information, see the Price Data Structure. |
A Price data structure |
OnHoldBalance |
The amount of pending bank transfers to your Amazon Mechanical Turk account. The value is a Price data structure. For more information, see the Price Data Structure. |