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

object

required

href linkrequired

templated boolean

transactions

object

required

href linkrequired

templated boolean

operations

object

required

href linkrequired

templated boolean

payments

object

required

href linkrequired

templated boolean

effects

object

required

href linkrequired

templated boolean

offers

object

required

href linkrequired

templated boolean

trades

object

required

href linkrequired

templated boolean

data

object

required

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

object

required

low_threshold integer

med_threshold integer

high_threshold integer

flags

object

required

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...