Retrieve an Account

GET 
/accounts/:account_id

The single account endpoint provides information on a specific account. The balances section in the response will also list all the trustlines this account has established, including trustlines that haven’t been authorized yet.

Request

Path Parameters

account_id stringrequired

This account’s public key encoded in a base32 string representation.

Responses

200

Returns details like balances, sponserships etc. about an account.

application/json

Schema

Schema

_links object
self object
href linkrequired
templated boolean
next object
href linkrequired
templated boolean
prev object
href linkrequired
templated boolean
_embedded object
records object[]
Array [
_links object
self objectrequired
href linkrequired
templated boolean
transactions objectrequired
href linkrequired
templated boolean
operations objectrequired
href linkrequired
templated boolean
payments objectrequired
href linkrequired
templated boolean
effects objectrequired
href linkrequired
templated boolean
offers objectrequired
href linkrequired
templated boolean
trades objectrequired
href linkrequired
templated boolean
data objectrequired
href linkrequired
templated boolean
id id (string)required
account_id address (string)required
Possible values: Value must match regular expression G[A-Z0-9]{55}
sequence sequence (string)required
Possible values: Value must match regular expression [0-9]+
sequence_ledger uint32
sequence_time string
subentry_count int32required
inflation_destination address (string)
Possible values: Value must match regular expression G[A-Z0-9]{55}
home_domain string
last_modified_ledger uint32required
last_modified_time stringrequired
thresholds objectrequired
low_threshold integer
med_threshold integer
high_threshold integer
flags objectrequired
auth_required boolean
auth_revocable boolean
auth_immutable boolean
auth_clawback_enabled boolean
balances object[]required
Array [
anyOf
BalanceLineNative
balance currency (string)required
Possible values: Value must match regular expression [0-9]+\.[0-9]{7}
liquidity_pool_id string
limit currency (string)required
Possible values: Value must match regular expression [0-9]+\.[0-9]{7}
buying_liabilites currency (string)required
Possible values: Value must match regular expression [0-9]+\.[0-9]{7}
selling_liabilites currency (string)required
Possible values: Value must match regular expression [0-9]+\.[0-9]{7}
sponser string
last_modified_ledger uint32required
is_authorized booleanrequired
is_authorized_to_maintain_liabilites booleanrequired
is_clawback_enabled booleanrequired
asset_type stringrequired
Possible values: [native]
BalanceLineAsset
balance currency (string)required
Possible values: Value must match regular expression [0-9]+\.[0-9]{7}
limit currency (string)required
Possible values: Value must match regular expression [0-9]+\.[0-9]{7}
buying_liabilites currency (string)required
Possible values: Value must match regular expression [0-9]+\.[0-9]{7}
selling_liabilites currency (string)required
Possible values: Value must match regular expression [0-9]+\.[0-9]{7}
sponser address (string)
Possible values: Value must match regular expression G[A-Z0-9]{55}
last_modified_ledger uint32required
is_authorized booleanrequired
is_authorized_to_maintain_liabilites booleanrequired
is_clawback_enabled booleanrequired
asset_type stringrequired
Possible values: [native, credit_alphanum4, credit_alphanum12]
asset_code stringrequired
asset_issuer address (string)required
Possible values: Value must match regular expression G[A-Z0-9]{55}
BalanceLineLiquidityPool
liquidity_pool_id stringrequired
asset_type stringrequired
Possible values: [liquidity_pool_shares]
balance currency (string)required
Possible values: Value must match regular expression [0-9]+\.[0-9]{7}
limit currency (string)required
Possible values: Value must match regular expression [0-9]+\.[0-9]{7}
last_modified_ledger uint32required
sponser address (string)
Possible values: Value must match regular expression G[A-Z0-9]{55}
is_authorized booleanrequired
is_authorized_to_maintain_liabilites booleanrequired
is_clawback_enabled booleanrequired
]
signers object[]required
Array [
key address (string)required
Possible values: Value must match regular expression G[A-Z0-9]{55}
weight int32required
type stringrequired
Possible values: [ed25519_public_key, sha256_hash, preauth_tx]
sponser address (string)
Possible values: Value must match regular expression G[A-Z0-9]{55}
]
data objectrequired
num_sponsoring integerrequired
num_sponsered integerrequired
sponser address (string)
Possible values: Value must match regular expression G[A-Z0-9]{55}
paging_token stringrequired
]

Example (from schema)

{
  "_links": {
    "self": {
      "href": "string",
      "templated": true
    },
    "next": {
      "href": "string",
      "templated": true
    },
    "prev": {
      "href": "string",
      "templated": true
    }
  },
  "_embedded": {
    "records": [
      {
        "_links": {
          "self": {
            "href": "string",
            "templated": true
          },
          "transactions": {
            "href": "string",
            "templated": true
          },
          "operations": {
            "href": "string",
            "templated": true
          },
          "payments": {
            "href": "string",
            "templated": true
          },
          "effects": {
            "href": "string",
            "templated": true
          },
          "offers": {
            "href": "string",
            "templated": true
          },
          "trades": {
            "href": "string",
            "templated": true
          },
          "data": {
            "href": "string",
            "templated": true
          }
        },
        "id": "string",
        "account_id": "string",
        "sequence": "string",
        "sequence_ledger": 0,
        "sequence_time": "string",
        "subentry_count": 0,
        "inflation_destination": "string",
        "home_domain": "string",
        "last_modified_ledger": 0,
        "last_modified_time": "string",
        "thresholds": {
          "low_threshold": 0,
          "med_threshold": 0,
          "high_threshold": 0
        },
        "flags": {
          "auth_required": true,
          "auth_revocable": true,
          "auth_immutable": true,
          "auth_clawback_enabled": true
        },
        "balances": [
          {
            "balance": "string",
            "liquidity_pool_id": "string",
            "limit": "string",
            "buying_liabilites": "string",
            "selling_liabilites": "string",
            "sponser": "string",
            "last_modified_ledger": 0,
            "is_authorized": true,
            "is_authorized_to_maintain_liabilites": true,
            "is_clawback_enabled": true,
            "asset_type": "native"
          },
          {
            "balance": "string",
            "limit": "string",
            "buying_liabilites": "string",
            "selling_liabilites": "string",
            "sponser": "string",
            "last_modified_ledger": 0,
            "is_authorized": true,
            "is_authorized_to_maintain_liabilites": true,
            "is_clawback_enabled": true,
            "asset_type": "native",
            "asset_code": "string",
            "asset_issuer": "string"
          },
          {
            "liquidity_pool_id": "string",
            "asset_type": "liquidity_pool_shares",
            "balance": "string",
            "limit": "string",
            "last_modified_ledger": 0,
            "sponser": "string",
            "is_authorized": true,
            "is_authorized_to_maintain_liabilites": true,
            "is_clawback_enabled": true
          }
        ],
        "signers": [
          {
            "key": "string",
            "weight": 0,
            "type": "ed25519_public_key",
            "sponser": "string"
          }
        ],
        "data": {},
        "num_sponsoring": 0,
        "num_sponsered": 0,
        "sponser": "string",
        "paging_token": "string"
      }
    ]
  }
}

RetrieveAnAccount

{
  "_links": {
    "self": {
      "href": "https://horizon-testnet.stellar.org/accounts/GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA"
    },
    "transactions": {
      "href": "https://horizon-testnet.stellar.org/accounts/GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA/transactions{?cursor,limit,order}",
      "templated": true
    },
    "operations": {
      "href": "https://horizon-testnet.stellar.org/accounts/GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA/operations{?cursor,limit,order}",
      "templated": true
    },
    "payments": {
      "href": "https://horizon-testnet.stellar.org/accounts/GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA/payments{?cursor,limit,order}",
      "templated": true
    },
    "effects": {
      "href": "https://horizon-testnet.stellar.org/accounts/GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA/effects{?cursor,limit,order}",
      "templated": true
    },
    "offers": {
      "href": "https://horizon-testnet.stellar.org/accounts/GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA/offers{?cursor,limit,order}",
      "templated": true
    },
    "trades": {
      "href": "https://horizon-testnet.stellar.org/accounts/GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA/trades{?cursor,limit,order}",
      "templated": true
    },
    "data": {
      "href": "https://horizon-testnet.stellar.org/accounts/GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA/data/{key}",
      "templated": true
    }
  },
  "id": "GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA",
  "account_id": "GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA",
  "sequence": "120192344791187470",
  "subentry_count": 5,
  "last_modified_ledger": 28105812,
  "num_sponsoring": 0,
  "num_sponsored": 0,
  "thresholds": {
    "low_threshold": 0,
    "med_threshold": 0,
    "high_threshold": 0
  },
  "flags": {
    "auth_required": false,
    "auth_revocable": false,
    "auth_immutable": false,
    "auth_clawback_enabled": false
  },
  "balances": [
    {
      "balance": "3.0000000",
      "limit": "922337203685.4775807",
      "buying_liabilities": "0.0000000",
      "selling_liabilities": "0.0000000",
      "last_modified_ledger": 27984507,
      "is_authorized": true,
      "is_clawback_enabled": false,
      "asset_type": "credit_alphanum4",
      "asset_code": "EURT",
      "asset_issuer": "GAP5LETOV6YIE62YAM56STDANPRDO7ZFDBGSNHJQIYGGKSMOZAHOOS2S"
    },
    {
      "balance": "4.0000000",
      "limit": "922337203685.4775807",
      "buying_liabilities": "0.0000000",
      "selling_liabilities": "0.0000000",
      "last_modified_ledger": 27985131,
      "is_authorized": true,
      "is_clawback_enabled": true,
      "asset_type": "credit_alphanum4",
      "asset_code": "USD",
      "asset_issuer": "GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX"
    },
    {
      "balance": "72.8563792",
      "buying_liabilities": "0.0000000",
      "selling_liabilities": "0.0000000",
      "asset_type": "native"
    }
  ],
  "signers": [
    {
      "weight": 1,
      "key": "GAYOLLLUIZE4DZMBB2ZBKGBUBZLIOYU6XFLW37GBP2VZD3ABNXCW4BVA",
      "type": "ed25519_public_key"
    }
  ],
  "data": {},
  "paging_token": ""
}

Loading...