/api/v1/compliance/iso-42001/statement-of-applicabilityGenerate ISO/IEC 42001 Statement of Applicability
Generates the SoA per Clause 6.1.3 by joining the static ISO 42001 Annex A registry with the org's `soc2_control_evidence` rows. Body: `orgId` (uuid, required), `scope?`, `version?` (default `1.0`), `format?` (json|csv, default json), `persist?` (default false). Applicability is a CATEGORY-level scope decision from the platform-feature map; implementation is judged PER CONTROL from evidence naming that control id, and is one of `not-applicable` (category unmapped), `not-assessed` (applicable but zero evidence for that control — the current state for every control, since evidence control_ids are SOC 2 CC* criteria), `partial` (1-9 rows) or `implemented` (10 or more). Each row carries applicability flag + reason, evidenceCount, lastEvidenceAt and evidenceBasis; the category roll-up is stated once in `categoryEvidence`. Coverage percentage = implemented / applicable, with `coverageBasis` distinguishing measured-0% from nothing-measured. Returns schemaVersion 1.1 plus a SHA-256 `snapshotHash` over the canonical JSON for tamper detection, `persisted`, and `mappingDrift` when a category key is dead. `format=csv` returns an RFC-4180 attachment with the hash in an `X-Snapshot-Hash` header; `persist=true` upserts into `soa_snapshots` on (org_id, framework, version). Requires `compliance:create` and org membership; audit-logged; 10 req/min.
Authentication
Send Authorization: Bearer YOUR_API_KEY on every request. Generate API keys at /dashboard/settings/api-keys.
Request body required
Example
{
"orgId": "00000000-0000-0000-0000-000000000000",
"scope": "<Optional override for the SoA's scope st>",
"version": "1.0",
"format": "json",
"persist": false
}Schema
{
"application/json": {
"schema": {
"type": "object",
"properties": {
"orgId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"scope": {
"type": "string",
"maxLength": 2000,
"description": "Optional override for the SoA's scope statement (defaults to 'All AI systems operated by the organization')."
},
"version": {
"default": "1.0",
"type": "string",
"maxLength": 50,
"description": "SoA version label set by the customer (e.g. '2.1' after a re-baseline)."
},
"format": {
"default": "json",
"type": "string",
"enum": [
"json",
"csv"
],
"description": "Set to 'csv' to receive an RFC-4180 attachment download. Snapshot hash returned via X-Snapshot-Hash response header in CSV mode."
},
"persist": {
"default": false,
"type": "boolean",
"description": "When true, upserts the SoA into soa_snapshots on (org_id, framework, version). Re-saving same version overwrites."
}
},
"required": [
"orgId",
"version",
"format",
"persist"
],
"additionalProperties": false
}
}
}Response
200 example
{
"success": true
}All status codes
Code samples
cURL
curl -X POST \
https://evalguard.ai/api/v1/compliance/iso-42001/statement-of-applicability \
-H "Authorization: Bearer $EVALGUARD_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "orgId": "00000000-0000-0000-0000-000000000000", "scope": "<Optional override for the SoA'\''s scope st>", "version": "1.0", "format": "json", "persist": false }'TypeScript
// The TypeScript SDK (@evalguard/sdk) exposes TYPED methods — runEval,
// getEval, runSecurityScan, checkFirewall, … — not a generic request().
// For an arbitrary endpoint, call it directly:
const res = await fetch("https://evalguard.ai/api/v1/compliance/iso-42001/statement-of-applicability", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.EVALGUARD_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"orgId": "00000000-0000-0000-0000-000000000000",
"scope": "<Optional override for the SoA's scope st>",
"version": "1.0",
"format": "json",
"persist": false
}),
});
console.log(res.status, await res.json());Python
# The Python SDK (pip install evalguardai) exposes TYPED methods on
# EvalGuardClient — run_eval, get_eval, … — not a generic request().
# For an arbitrary endpoint, call it directly:
import os
import requests
headers = {"Authorization": f"Bearer {os.environ['EVALGUARD_API_KEY']}"}
headers["Content-Type"] = "application/json"
response = requests.request(
"POST",
"https://evalguard.ai/api/v1/compliance/iso-42001/statement-of-applicability",
headers=headers,
json={
"orgId": "00000000-0000-0000-0000-000000000000",
"scope": "<Optional override for the SoA's scope st>",
"version": "1.0",
"format": "json",
"persist": False
},
)
print(response.status_code, response.json())Go
package main
import (
"context"
"fmt"
"net/http"
"os"
"strings"
)
func main() {
body := strings.NewReader(`{"orgId":"00000000-0000-0000-0000-000000000000","scope":"<Optional override for the SoA's scope st>","version":"1.0","format":"json","persist":false}`)
req, _ := http.NewRequestWithContext(context.Background(), "POST", "https://evalguard.ai/api/v1/compliance/iso-42001/statement-of-applicability", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("EVALGUARD_API_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
fmt.Println(resp.Status)
}