GetTotemApprovalStatus

Retrieves the approval status of a totem on a specific chain or across all chains.

Endpoint: GET /nxt?requestType=GetTotemApprovalStatus

Parameters:

• totem (long, required): The totem ID

Request Example: /nxt?requestType=GetTotemApprovalStatus&totem=123456789

Response (with chain parameter):

{
  "totem": "123456789",
  "chain": 1,
  "isApproved": true,
  "isRegistered": true,
  "status": "APPROVED",
  "approvalHistory": [
    {
      "id": "111111111",
      "height": 123456,
      "approver": "999999999",
      "status": "APPROVED",
      "expirationHeight": 234567
    }
  ]
}

Response (without chain parameter):

{
  "totem": "123456789",
  "activeApprovals": [
    {
      "chain": 1,
      "approval": {
        "id": "111111111",
        "height": 123456,
        "approver": "999999999",
        "status": "APPROVED",
        "expirationHeight": 234567
      }
    }
  ],
  "approvedChains": [1, 2, 3]
}

Response Fields:

• totem: string - Totem ID (unsigned string)
• chain: number - Chain ID (only when chain parameter provided)
• isApproved: boolean - Whether totem is approved on this chain
• isRegistered: boolean - Whether totem is registered on this chain
• status: string - Current status (APPROVED, PENDING, REJECTED, NOT_REGISTERED)
• approvalHistory: array - Array of approval history entries (chain-specific)
• approvalHistory[].id: string - Approval request ID (unsigned string)
• approvalHistory[].height: number - Block height of approval
• approvalHistory[].approver: string - Approver account ID (unsigned string)
• approvalHistory[].status: string - Approval status
• approvalHistory[].expirationHeight: number - Expiration block height
• activeApprovals: array - Array of active approvals across chains (no chain param)
• activeApprovals[].chain: number - Chain ID
• activeApprovals[].approval: object - Approval object with id, height, approver, status, expirationHeight
• approvedChains: number[] - Array of chain IDs where totem is approved

Source: GetTotemApprovalStatus.java Notes: With chain parameter returns status for that specific chain. Without chain returns status across all chains. Not chain-specific.