Governance

Aggregated citation-integrity KPI feed

Aggregated citation-integrity score per sub-key × period — the KPI feed a client's risk committee ingests (Nexus SERVES the data; the client governs). Aggregates integrity_events: counts of the 6 CitationStatus values, broken/verified/not_verifiable rates, mean Node B (audit) confidence and byo_share. NEVER per-request rows nor canonical norm ids.

Ownership (a child key never sees another sub-key's data):

  • child → its own api_key_id only.
  • master → the whole organization (organization_id).
  • solo/legacy → the caller's user_id.

Anti-fingerprinting k-anonymity: buckets below the minimum run count (currently 5, operator-configurable) suppress the fine metrics — mean_nodo_b_confidence and all rates become null and every counts value plus total are rounded to the nearest multiple of 5. Suppression is a WITHHELD measurement, not a measured zero: a null rate says the bucket was too small to report, never that nothing was found. Confidence is already stored COARSE (0.05 steps); no cross-tenant jurisdiction breakdown.

get/api/v1/integrity

Request

  • Base URL: https://legal.nexusquantum.legal
  • URL: https://legal.nexusquantum.legal/api/v1/integrity
  • Auth: HTTP bearer

Query parameters

fromstring date

ISO date inclusive (default: 30 days ago).

tostring date

ISO date inclusive (default: today).

period'day' | 'week' | 'month'

Time bucketing; omit for a single all bucket over the range.

api_key_idstring uuid

Filter to a specific sub-key (403 FORBIDDEN_CHILD_KEY for a child asking about a foreign key; 404 for a master asking about a non-member key).

group_by'key' | 'key_jurisdiction'

Add a per-jurisdiction breakdown over the caller's OWN data (never cross-tenant).

Response

Aggregated integrity buckets.

verify_engine_versionstring required
requestIdstring

Example response

{
  "data": [
    {
      "key_prefix": "nlk_ab12",
      "period": "2026-07-06"
    }
  ],
  "verify_engine_version": "2026-06-08.1"
}

Changes

No recorded changes to this operation across all 1 revision of this API.