---
title: "Control-Test Evidence Composer"
method: POST
path: "/v1/tools/compose_control_test_evidence"
tags: ["TODO_TAGS_REVIEW", "TODO_AP2_EXPORT_REVIEW"]
---

# Control-Test Evidence Composer

`POST /v1/tools/compose_control_test_evidence`

## Request

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

Composes a SOX 404 / ICFR control-test evidence artifact: reconciles a caller-declared attribute sample (item ids, e.g. from art-458) against a per-item pass/fail test-result set into one test-conclusion record -- sample coverage, exception count vs a caller-set tolerable-deviation threshold, and a test conclusion (operating effectively / exception noted / incomplete). The tester is recorded under the SOX 404 / PCAOB AS 1215 preparer role; every test carries a fixed review_required gate for reviewer sign-off. An exception count above zero flags a deficiency CANDIDATE only -- severity classification and its reason_code are a separate human reviewer approval record, never computed here. Deterministic reconciliation only. Zero network, zero PII.

**Tool URL:** https://ainumbers.co/chaingraph/art-461-control-test-evidence-composer.html

## Request body

- object
  - `control_id` unknown, required
  - `population_hash` unknown, required
  - `reporting_period` unknown, required
  - `sample` unknown[], required
    - unknown
  - `test_results` unknown[], required
    - unknown
  - `tester_id` unknown, required
  - `tolerable_exception_count` unknown, required

## Response `200`

Successful tool execution result

- object
  - `control_id` string
  - `coverage_complete` boolean
  - `deficiency` string
  - `exception_count` integer
  - `exception_rate` integer
  - `extra_results` unknown[]
    - unknown
  - `fail_count` integer
  - `gate_status` string
  - `missing_results` unknown[]
    - unknown
  - `not_a_severity_judgment` string
  - `pass_count` integer
  - `population_hash` string
  - `reporting_period` string
  - `sample_size` integer
  - `test_conclusion` string
  - `tested_count` integer
  - `tester_id` string
  - `tester_role` string
  - `tolerable_exception_count` integer
  - `within_tolerance` boolean

---

[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)