Skip to main content

GetTotemApprovalAuditTrail

Retrieves the complete audit trail for a totem's approval history on a specific chain.

Endpoint: GET /nxt?requestType=GetTotemApprovalAuditTrail

Parameters:

  • totem (long, required): The totem ID

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

Response:

{
  "totem": "123456789",
  "chain": 1,
  "auditTrail": [
    {
      "id": "111111111",
      "action": "APPROVAL_REQUESTED",
      "approverId": "999999999",
      "timestamp": 123456789,
      "height": 123456,
      "status": "APPROVED"
    }
  ],
  "totalEntries": 10
}

Response Fields:

  • totem: string - Totem ID (unsigned string)
  • chain: number - Chain ID
  • auditTrail: array - Array of audit trail entries
  • auditTrail[].id: string - Audit entry ID (unsigned string)
  • auditTrail[].action: string - Action type (APPROVAL_REQUESTED, APPROVAL_GRANTED, STATUS_CHANGE, etc.)
  • auditTrail[].approverId: string - Account ID of the approver (unsigned string)
  • auditTrail[].timestamp: number - Timestamp of the action
  • auditTrail[].height: number - Block height of the action
  • auditTrail[].status: string - Current status
  • totalEntries: number - Total number of audit trail entries

Source: GetTotemApprovalAuditTrail.java, TotemApproval.getComplianceAuditTrail() Notes: Returns the complete audit trail for the totem on the specified chain. All IDs are converted to unsigned string representations. Not chain-specific.