Honeycluster Docs – Get an account profile

accounts

Get an account profile

get

/accounts/{address}

operationId: account-getDetail

Returns the consolidated profile for an XRPL address — core on-chain account fields, curated metadata (name, icon, category, advisory), and tracking status. Fully populated for tracked accounts; untracked addresses return null fields.

Authorizations

Name	Location	Details
`BearerAuth`	Authorization header · bearer	JWT issued by the Honeycluster auth service for the `indexer` audience. Present as `Authorization: Bearer <token>`.

Path Parameters

Name	Type	Default	Description
`address` required	string		XRPL account address (r-address).

Responses

200

application/json

Successful response

Field	Type	Description
`account`	object
`metadata`	object
`tracked`	object
`counts`	object	Rollup object counts. Zero-initialized when the account has no rollup rows yet.
`counts.nfts_owned`	integer	NFTs currently owned by the account.
`counts.nfts_burned`	integer	NFTs previously owned that are now burned.
`counts.trustlines`	integer	Trustlines held (any limit or balance).
`counts.trustlines_non_zero`	integer	Trustlines with a positive balance.
`counts.escrows`	integer	Active escrow objects held by the account.
`counts.checks`	integer	Active check objects held by the account.
`counts.amm_positions`	integer	AMM positions (inferred from non-zero LP trustlines).
`counts.mpt_holdings`	integer	MPT issuances with a holder record for this account.
`counts.active_offers`	integer	Outstanding order-book offers owned by the account.

Example

Json

{
  "account": {
    "address": "string",
    "parentAccount": "string",
    "createdLedger": 0,
    "firstSeenAt": 1745798400,
    "currentBalanceDrops": "string",
    "flags": 0,
    "isBlackholed": false,
    "domain": "string",
    "emailHash": "string",
    "regularKey": "string",
    "transferRate": 0,
    "tickSize": 0,
    "nftokenMinter": "string",
    "isAmm": false,
    "deletedLedger": 0,
    "lastLedgerSeen": 0,
    "lastSeenAt": 1745798400,
    "createdAt": 1745798400,
    "updatedAt": 1745798400
  },
  "metadata": {
    "address": "string",
    "name": "string",
    "description": "string",
    "iconUrl": "string",
    "iconSourceUrl": "string",
    "bannerUrl": "string",
    "bannerSourceUrl": "string",
    "socialLinks": "string",
    "category": "string",
    "isLaunchpad": false,
    "isBroker": false,
    "isExchange": false,
    "isValidator": false,
    "verified": false,
    "verifiedBy": "string",
    "kycVerified": false,
    "kycProvider": "string",
    "kycLevel": "string",
    "kycVerifiedAt": 1745798400,
    "kycReference": "string",
    "advisorySeverity": "string",
    "advisoryMessage": "string",
    "advisorySource": "string",
    "tags": [
      "string"
    ],
    "createdAt": 1745798400,
    "updatedAt": 1745798400
  },
  "tracked": {
    "address": "string",
    "source": "string",
    "reason": "string",
    "active": false,
    "backfillCompletedAt": 1745798400,
    "addedAt": 1745798400,
    "updatedAt": 1745798400
  },
  "counts": {
    "nfts_owned": 0,
    "nfts_burned": 0,
    "trustlines": 0,
    "trustlines_non_zero": 0,
    "escrows": 0,
    "checks": 0,
    "amm_positions": 0,
    "mpt_holdings": 0,
    "active_offers": 0
  }
}

400

application/json

Invalid input data

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}

401

application/json

Authorization not provided

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}

403

application/json

Insufficient access

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}

404

application/json

Not found

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}

500

application/json

Internal server error

Field	Type	Description
`message`	string	The error message
`code`	string	The error code
`issues`	object[]	An array of issues that were responsible for the error
`issues[].message`	string

Example

Json

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}