Skip to main content

GetTotemApprovalComplianceReport

Generates a compliance report for a chain within a specified block range.

Endpoint: GET /nxt?requestType=GetTotemApprovalComplianceReport

Parameters:

  • firstIndex (int, optional, default: 0): Starting block height for the report
  • lastIndex (int, optional, default: current): Ending block height for the report

Request Example: /nxt?requestType=GetTotemApprovalComplianceReport&firstIndex=100000&lastIndex=120000

Response:

{
  "chain": 1,
  "startHeight": 100000,
  "endHeight": 120000,
  "totalApprovals": 100,
  "totalRejections": 5,
  "totalPending": 2,
  "totalExpired": 1,
  "approvalsByTotem": {
    "123456789": {
      "total": 10,
      "approved": 8,
      "rejected": 2,
      "pending": 0
    }
  }
}

Response Fields:

  • chain: number - Chain ID for this report
  • startHeight: number - Starting block height
  • endHeight: number - Ending block height
  • totalApprovals: number - Total approvals in the range
  • totalRejections: number - Total rejections in the range
  • totalPending: number - Total pending approvals
  • totalExpired: number - Total expired approvals
  • approvalsByTotem: object - Approval statistics per totem
  • approvalsByTotem.totemId.total: number - Total approval requests for this totem
  • approvalsByTotem.totemId.approved: number - Approved count
  • approvalsByTotem.totemId.rejected: number - Rejected count
  • approvalsByTotem.totemId.pending: number - Pending count

Source: GetTotemApprovalComplianceReport.java, TotemApproval.generateComplianceReport() Notes: Requires full client. Returns chain-specific compliance data. Not chain-specific.