Epochs

Epochs anchor the operation chain into a Merkle root every 5 minutes. Each epoch covers the operations received during its window.

List Epochs

GET

/v1/epochs

List all epochs for the organization.

Auth: org_owner, security_admin, compliance_auditor, integration_engineer, readonly_investigator

Response

json

{
  "epochs": [
    {
      "epoch_id": "0195f2c8-4d6e-7f8a-9b0c-1d2e3f4a5b6c",
      "org_id": "org_acme",
      "start_time": 1772287200000,
      "end_time": 1772287500000,
      "root_hash": "<base64url Merkle root>",
      "leaf_count": 1247,
      "r2_epoch_key": "<object storage key>",
      "created_at": 1772287500000
    }
  ]
}

Get Epoch

GET

/v1/epochs/:epoch_id

Retrieve one epoch record and its RFC 3161 anchor when present.

Auth: org_owner, security_admin, compliance_auditor, integration_engineer, readonly_investigator

Path Parameters

Field	Type	Required	Description
epoch_id	string	Yes	The epoch identifier

Response

json

{
  "epoch": {
    "epoch_id": "0195f2c8-4d6e-7f8a-9b0c-1d2e3f4a5b6c",
    "org_id": "org_acme",
    "start_time": 1772287200000,
    "end_time": 1772287500000,
    "root_hash": "<base64url Merkle root>",
    "leaf_count": 1247,
    "r2_epoch_key": "<object storage key>",
    "created_at": 1772287500000
  },
  "anchor": {
    "tsa_url": "http://timestamp.sectigo.com",
    "tsa_token": "<base64 RFC 3161 token>",
    "anchored_at": 1772287560000
  }
}