Epochs

Epochs are periodic snapshots that anchor the operation chain into a Merkle root. Each epoch covers a time window and includes all operations submitted during that period.

List Epochs

GET

/v1/epochs

List all epochs for the organization.

Auth: readonly_investigator

Query Parameters

Field	Type	Required	Description
cursor	string	No	Pagination cursor
limit	number	No	Results per page (default 50, max 200)

Response

json

{
  "data": [
    {
      "epoch_id": "epoch_001",
      "start_time": "2026-02-28T00:00:00Z",
      "end_time": "2026-02-28T06:00:00Z",
      "leaf_count": 1247,
      "root_hash": "sha256:merkle_root_abc...",
      "hash_alg": "SHA-256"
    }
  ],
  "nextCursor": "eyJpZCI6MX0=",
  "hasMore": true
}

Get Epoch

GET

/v1/epochs/:epoch_id

Retrieve full epoch details including Merkle root and Elydora signature.

Auth: readonly_investigator

Path Parameters

Field	Type	Required	Description
epoch_id	string	Yes	The epoch identifier

Response

json

{
  "epoch_id": "epoch_001",
  "org_id": "org_acme",
  "start_time": "2026-02-28T00:00:00Z",
  "end_time": "2026-02-28T06:00:00Z",
  "leaf_count": 1247,
  "root_hash": "sha256:merkle_root_abc...",
  "hash_alg": "SHA-256",
  "signature_by_elydora": "base64-elydora-epoch-sig..."
}