Get integrity certificate

Retrieve or reconstruct the IntegrityCertificate for a checkpoint. Includes signature, chain proof, Merkle inclusion proof (if available), and verdict derivation proof (if completed). Public endpoint, no authentication required.

GET /v1/checkpoints/{checkpoint_id}/certificate

Get integrity certificate

cURL

curl --request GET \
  --url https://api.mnemom.ai/v1/v1/checkpoints/{checkpoint_id}/certificate

200

{
  "@context": "https://mnemom.ai/aip/v1",
  "type": "IntegrityCertificate",
  "version": "<string>",
  "certificate_id": "<string>",
  "issued_at": "2023-11-07T05:31:56Z",
  "subject": {
    "checkpoint_id": "<string>",
    "agent_id": "<string>",
    "session_id": "<string>",
    "card_id": "<string>"
  },
  "claims": {
    "verdict": "clear",
    "concerns": [
      {
        "category": "<string>",
        "severity": "<string>",
        "description": "<string>"
      }
    ],
    "confidence": 123,
    "reasoning_summary": "<string>",
    "analysis_model": "<string>",
    "analysis_duration_ms": 123
  },
  "input_commitments": {
    "thinking_block_hash": "<string>",
    "card_hash": "<string>",
    "values_hash": "<string>",
    "context_hash": "<string>",
    "model_version": "<string>",
    "combined_commitment": "<string>"
  },
  "proofs": {
    "signature": {
      "algorithm": "Ed25519",
      "key_id": "<string>",
      "value": "<string>",
      "signed_payload": "<string>"
    },
    "chain": {
      "chain_hash": "<string>",
      "prev_chain_hash": "<string>",
      "position": 123
    },
    "merkle": {
      "leaf_hash": "<string>",
      "leaf_index": 123,
      "root": "<string>",
      "tree_size": 123,
      "inclusion_proof": [
        {
          "hash": "<string>",
          "position": "left"
        }
      ]
    },
    "verdict_derivation": {
      "method": "SP1-STARK",
      "image_id": "<string>",
      "receipt": "<string>",
      "journal": "<string>",
      "verified_at": "2023-11-07T05:31:56Z"
    }
  },
  "verification": {
    "keys_url": "<string>",
    "certificate_url": "<string>",
    "verify_url": "<string>"
  }
}

Path Parameters

checkpoint_id · string · required

The checkpoint ID (ic-{uuid} format)

Response

200

application/json

The integrity certificate

Machine-readable cryptographic certificate for an integrity checkpoint. Modeled on C2PA content credentials and W3C Verifiable Credentials.

@context · enum<string> · required

Namespace identifier

Available options: https://mnemom.ai/aip/v1

type · enum<string> · required

Available options: IntegrityCertificate

version · string · required

Certificate format version

certificate_id · string · required

Unique certificate identifier (cert-{8 random chars})

issued_at · string<date-time> · required

ISO 8601 timestamp of certificate issuance

subject · object · required

Identifies the checkpoint this certificate attests to

Show child attributes

claims · object · required

Analysis verdict and supporting evidence

Show child attributes

input_commitments · object · required

Cryptographic commitments to analysis inputs

Show child attributes

proofs · object · required

Cryptographic evidence supporting the claims

Show child attributes

verification · object · required

URLs for independent verification

Show child attributes