The GetAccountBalance operation retrieves the amount of money in the Amazon.com account of the user calling the operation.
Using GetAccountBalance (REST)
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] &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 GetAccountBalance operation, set the Operation parameter to GetAccountBalance. |
Required |
GetAccountBalance |
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 |
The user's account balance. The value is a Price data structure. For more information, see the Price Data Structure. |
A Price data structure |