Get Account Settings

Get an account's settings. These are the settings that can be modified by the user. By default, this method returns data from the 'current' (in-progress) ledger, which may change before validation.

Warning: XAG-API is early alpha software. API methods and data formats are likely to change frequently in ways that break backwards compatibility.

Request Format

GET /accounts/{address}/settings

This API method uses the following path parameters:

Field	Value	Required?	Description
address	String (Address)	Required	The account to query.

This API method uses the following query parameters:

Field	Value	Required?	Description
ledger_index	(Varies) (LedgerIndex)	Optional	(Optional) The sequence number of the ledger to use, or a shortcut string to choose a ledger automatically. (See Specifying Ledgers )

Response Formats

404 Not Found

Not found

Media type: application/json

Formatted as a RippleAPIError

The response uses the following fields:

Field	Type	Required?	Description
errors	Array of ErrorItem	May be omitted	A list of errors that occurred when processing this request.
message	String	May be omitted	A human-readable error message summarizing the problem(s) that occurred.

400 Bad Request

The request was not properly formatted.

Media type: application/json

Formatted as a RippleAPIError

The response uses the following fields:

Field	Type	Required?	Description
errors	Array of ErrorItem	May be omitted	A list of errors that occurred when processing this request.
message	String	May be omitted	A human-readable error message summarizing the problem(s) that occurred.

200 OK

A successful response contains the settings data for the requested account.

Media type: application/json

Formatted as a AccountSettings

The response uses the following fields:

Field	Type	Required?	Description
signers	Object	May be omitted	(Optional) Settings that determine what sets of accounts can be used to sign a transaction on behalf of this account using multisigning.
passwordSpent	Boolean	May be omitted	(Optional) Account has used its free SetRegularKey transaction.
disallowIncomingXAG	Boolean	May be omitted	(Optional) Client applications should not send XAG to this account. Not enforced by rippled.
requireDestinationTag	Boolean	May be omitted	(Optional) Account requires incoming payments to specify a destination tag.
tickSize	Number	May be omitted	(Optional) Tick size to use for offers involving a currency issued by this address. The exchange rates of those offers is rounded to this many significant digits. Valid values are 3 to 15 inclusive, or 0 to disable.
walletLocator	String	May be omitted	(Optional) Transaction hash or any other 64 character hexadecimal string, that may or may not represent the result of a hash operation. Use null to clear.
domain	String	May be omitted	(Optional) The domain that owns this account, as a hexadecimal string representing the ASCII for the domain in lowercase.
disableMasterKey	Boolean	May be omitted	If the master key is disabled, true; false otherwise.
emailHash	String	May be omitted	(Optional) Hash of an email address to be used for generating an avatar image. Conventionally, clients use Gravatar to display this image. Use null to clear.
transferRate	Number	May be omitted	(Optional) The fee to charge when users transfer this account’s issuances, as the decimal amount that must be sent to deliver 1 unit. Has precision up to 9 digits beyond the decimal point. Use null to set no fee.
regularKey	String (Address)	May be omitted	The address of an XAG Ledger account.