AI Trust Registry Data Contracts

Asset Score Request (POST /v1/assets/score)

Required fields

Field	Type
tenant_id	string
asset_id	string
event_id	string
score_version	string
evidence_events	TrustRegistryEvidenceEvent[]

Optional fields

Field	Type
discovery_confidence	number (0-1)
control_readiness	number (0-1)

Evidence event shape

{
  "evidence_id": "asset-ev-a-1",
  "event_type": "inventory.scanned",
  "quality": 0.9,
  "completeness": 0.8,
  "weight": 1.0
}

Agent Score Request (POST /v1/agents/score)

Required fields

Field	Type
tenant_id	string
agent_id	string
event_id	string
score_version	string
evidence_events	TrustRegistryEvidenceEvent[]

Optional fields

Field	Type
identity_confidence	number (0-1)
oversight_readiness	number (0-1)

Asset Response Shape

{
  "accepted": true,
  "tenant_id": "tenant-a",
  "actor_id": "actor-a",
  "request_id": "fixture-tr-asset-positive-a",
  "asset_id": "asset-a-001",
  "entity_id": "asset-a-001",
  "event_id": "evt-asset-a-1001",
  "score_version": "provenance_v0",
  "scores": {
    "provenance_v0": 0.79,
    "meridian_v0": 0.7833,
    "composite_v0": 0.787
  },
  "risk_priority": "medium",
  "trend": {
    "direction": "flat",
    "delta": 0.0,
    "previous_composite_v0": null,
    "current_composite_v0": 0.787
  },
  "lineage": {
    "evidence_event_id": "53f28c42-53cc-4e0f-ac55-3ec0589eb073",
    "score_snapshot_id": "7e889839-f714-4e4e-8f96-4728ef3087fc"
  }
}

Agent Response Shape

{
  "accepted": true,
  "tenant_id": "tenant-b",
  "actor_id": "actor-b",
  "request_id": "fixture-tr-agent-positive-b",
  "agent_id": "agent-b-003",
  "entity_id": "agent-b-003",
  "event_id": "evt-agent-b-2002",
  "score_version": "mandate_v0",
  "scores": {
    "provenance_v0": 0.672,
    "mandate_v0": 0.5675,
    "meridian_v0": 0.618,
    "composite_v0": 0.6192
  },
  "recommended_action": "review",
  "trend": {
    "direction": "flat",
    "delta": 0.0,
    "previous_composite_v0": null,
    "current_composite_v0": 0.6192
  },
  "lineage": {
    "evidence_event_id": "f0419f96-5d18-43f6-bf65-2cef7e71f71b",
    "score_snapshot_id": "15797fe6-b067-4967-8cca-6965f53a7a89"
  }
}

Score Lookup Response (GET /v1/score/{framework}/{entity_id})

{
  "tenant_id": "tenant-a",
  "framework": "trust_registry_asset_v0",
  "entity_id": "asset-a-001",
  "score_snapshot_id": "7e889839-f714-4e4e-8f96-4728ef3087fc",
  "evidence_event_id": "53f28c42-53cc-4e0f-ac55-3ec0589eb073",
  "event_id": "evt-asset-a-1001",
  "score_version": "provenance_v0",
  "score_payload": {
    "asset_id": "asset-a-001",
    "scores": {
      "provenance_v0": 0.79,
      "meridian_v0": 0.7833,
      "composite_v0": 0.787
    },
    "risk_priority": "medium"
  },
  "created_at": "2026-03-05T00:00:00Z"
}