---
title: "Signed current Merkle root for the canonical-card transparency log."
method: GET
path: "/transparency/root"
tags: ["Transparency"]
---

# Signed current Merkle root for the canonical-card transparency log.

`GET /transparency/root`

## Request

- Base URL: `https://api.mnemom.ai/v1`
- URL: `https://api.mnemom.ai/v1/transparency/root`
- Auth: none required

Returns the current root + tree_size + published_at, signed by the active AAP signing key. Distinct `typ` from per-card attestations (`AAP-TransparencyRoot/v1`). Cacheable for 30 seconds; consumers refresh when they want a fresh root. cards-as-primitive Phase 5 A2.

## Response `200`

Signed root, or an empty-state payload when the log has no entries.

- union
  - object
    - `typ` 'AAP-TransparencyRoot/v1', required: Domain separator distinguishing a signed root from a per-card attestation.
    - `tree_size` integer, required
    - `root_hash` string, required
    - `published_at` string, date-time, required
    - `signing_key_id` string, required
    - `signature` string, required: Base64url Ed25519 signature over canonical_json(commitment), where commitment is this object MINUS `signature` — i.e. {typ, tree_size, root_hash, published_at, signing_key_id}. Verify by dropping `signature`, canonicalising the rest (sorted keys, no whitespace), and checking against the JWKS key for signing_key_id.
  - object
    - `tree_size` unknown, required
    - `message` string

## Other responses

- `429`: Rate-limit exceeded. The global per-IP limiter (100 requests/minute, applied to every `/v1/*` route) rejected this request. Back off until the window resets — `Retry-After` carries the cooldown in seconds and `X-RateLimit-Reset` the absolute reset time.
- `500`: Server error — request was well-formed but the server failed to fulfill it. Typically a downstream dependency (DB / RPC / external API) returned an unexpected error.
- `503`: An upstream dependency is currently unavailable. The request was not processed; retry after the cooldown window.

---

[API](https://skmtc.dev/mnemom/apis/mnemom-api.md) · [All operations](https://skmtc.dev/mnemom/apis/mnemom-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mnemom/apis/mnemom-api/revisions/274b7a6ea182?raw)