---
title: "Control Attestation Campaign Roll-Up"
method: POST
path: "/v1/tools/compute_control_attestation_campaign_roll_up"
tags: ["control attestation", "campaign completion", "exception rate", "escalation threshold", "roll-up", "SOX 404", "ICFR", "zero network", "zero-PII"]
---

# Control Attestation Campaign Roll-Up

`POST /v1/tools/compute_control_attestation_campaign_roll_up`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/compute_control_attestation_campaign_roll_up`
- Auth: none declared

Roll-up of a caller-declared control-attestation campaign: completion percentage, exception rate, below-threshold flag against a declared escalation threshold, and an ESCALATION_FLAGGED / NO_ESCALATION verdict. Declared counts only: attested, exception, and unresponded are your declarations, never observations this page makes; it reads no register, GRC system, or control repository. Absent or invalid inputs fail closed and are named. Rounding is 2dp half-up. No network, no storage, no clock.

**Tool URL:** https://ainumbers.co/tools/680-control-attestation-campaign-roll-up.html
**AP2/Policy Mandate export:** yes

## Request body

- object
  - `controls_total` number, required: Declared total controls, integer in [1, 100000].
  - `attested` number, required: Declared attested controls, integer in [0, controls_total].
  - `exceptions` number, required: Declared exceptions, integer in [0, controls_total].
  - `unresponded` number, required: Declared unresponded control owners, integer in [0, controls_total].
  - `escalation_threshold_pct` number, required: Declared escalation threshold, number in [0, 100].

## Response `200`

Successful tool execution result

- object
  - `completion_pct` number, nullable
  - `exception_rate_pct` number, nullable
  - `below_threshold` boolean, nullable
  - `overall` string, nullable
  - `trace` string
  - `domain_errors` unknown[]
    - unknown

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)