Honeycluster Docs – Batch resolve account profiles by address

accounts

Batch resolve account profiles by address

post

/accounts/batch

operationId: account-getDetails

Batch version of /accounts/{address}. Body: { "addresses": ["rFoo…", "rBar…"] } (max 100). Returns each resolved account in the same shape — core on-chain state, curated metadata, tracking status, and rollup counts. Addresses with no indexed data are silently omitted.

Authorizations

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

Request Body

application/json

required

Field	Type	Description
`addresses` required	string[]	XRPL addresses to resolve (max 100). Unmatched addresses are silently omitted.

Example

Json

{
  "addresses": [
    "string"
  ]
}

Responses

200

application/json

Successful response

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

Example

Json

{
  "items": [
    {
      "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": []
}

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": []
}