Get started

Organisation audit attestation pack

Source

Export a read-only vitna.audit-pack.v1 procurement, FinOps, and model-governance attestation pack across an authenticated organisation's registered workloads, standing decisions, signed policy, and attested Witness prices.

text
GET /api/v1/org/audit-pack
bash
curl "https://vitna.ai/api/v1/org/audit-pack?monthlyRuns=10000&discoverPeers=true&download=1" \
  -H "Authorization: Bearer vitna_key_..."

Accepts either an organisation platform key (vitna_key_...) or push key (vitna_push_...). Queries aperture.* and witness.* through the read-only site role (vitna_site) and mutates nothing. Like `GET /api/v1/decisions/{id}/pack`, this route serves an unsigned pack stamped with its canonical SHA-256 digest; operators who sign packs with their own Ed25519 key run `npm run aperture:audit:pack -- --sign`. See Audit and procurement attestation packs for the six-layer offline verification contract.

Query parameters

ParameterMeaning
stagesOptional comma-separated <slug>[:<invocationsPerRun>][:bg] stage list for the compound pipeline BOM
monthlyRunsOptional positive integer monthly pipeline execution volume (alias runs)
discoverPeersWhen true, include active Witness class-peer exploratory spend levers (false by default)
includePolicyInclude the organisation's latest signed aperture.artifact policy envelope (true by default)
windowOptional YYYY-MM-DD..YYYY-MM-DD UTC date filter for Witness observation Merkle proofs
labelOptional human-readable release or procurement review label
downloadWhen 1 or true, set Content-Disposition: attachment; filename="vitna-<org>-audit-pack.json"

Response shape

json
{
  "schema": "vitna-audit-pack-v1",
  "format": "vitna.audit-pack.v1",
  "orgId": "convexity",
  "orgName": "Convexity",
  "label": "q4-procurement-review",
  "generatedAt": "2026-11-06T00:00:00.000Z",
  "sentence": "Audit pack for convexity covers 3 active workloads, 2 standing decisions, 4 attested Witness observations, estimated spend $940.00/mo, rollout status healthy.",
  "summary": {
    "workloadCount": 3,
    "standingDecisionCount": 2,
    "pricePeriodCount": 4,
    "attestedObservationCount": 4,
    "unattestedObservationCount": 0,
    "enteredPriceCount": 0,
    "providerTermCount": 4,
    "capabilitySkuCount": 3,
    "evidenceCount": 2,
    "pipelineCount": 1,
    "totalEstimatedMonthlySpendUsd": 940,
    "verifiedMonthlySavingsUsd": 0,
    "watchdogVerdict": "healthy",
    "policyIncluded": true,
    "lockIncluded": false
  },
  "claims": { ... },
  "governance": {
    "stackfile": { ... },
    "stackfileDigest": "7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b",
    "standingDecisions": [ ... ],
    "policyEnvelope": { ... },
    "policyLock": null
  },
  "pricingAndProvenance": {
    "witnessPricePeriods": [ ... ],
    "observationProofs": [ ... ],
    "enteredPrivatePrices": []
  },
  "complianceAndCapabilities": {
    "providerTerms": [ ... ],
    "capabilityReadings": [ ... ],
    "admissibilityRules": { ... },
    "customerEvidence": [ ... ]
  },
  "operations": {
    "rolloutWatchdog": { ... },
    "compoundPipelines": [ ... ]
  },
  "digest": "4f3b9a8e01c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8",
  "meta": {
    "generatedAt": "2026-11-06T00:00:00.000Z",
    "workloadCount": 3,
    "attestedObservationCount": 4
  }
}