Skip to content
Beam Docs
Telemetry

Complete published epoch sets

GET
/v1/telemetry/epochs

Paid history tier. Organization key and telemetry:read required. One-epoch publication delay, shared immutable versions and 30-day retention. Filters do not recompute ranks or shares. Cursor filters and pinned snapshot/version must remain unchanged between pages. No private storage or participant timing claims are disclosed.

Authorization

consoleKey
X-Api-Key<token>

Organization Console API key. Explicit telemetry:read (realtime: telemetry:realtime:read), prepaid credits, organization/project grant; no environment-only grant.

In: header

Query Parameters

limit?integer
Range1 <= value <= 100
Default100
cursor?string
Lengthlength <= 1024
snapshotId?string
Formatuuid
since?string
Formatdate-time
until?string
Formatdate-time

Header Parameters

If-None-Match?string

ETag of a payload already held; a match answers 304 without a charge.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/telemetry/epochs"
{  "nextCursor": "string",  "items": [    {      "snapshotId": "09520abc-01e6-4da1-8fa5-f10e3883c861",      "version": "string",      "observedAt": "2019-08-24T14:15:22Z",      "sourceEpoch": 0,      "formulaReference": "http://example.com",      "publishedAt": "2019-08-24T14:15:22Z",      "evidenceSequence": "string",      "data": {        "epoch": 0,        "formulaVersion": "string",        "epochSummaryVersion": "2019-08-24T14:15:22Z",        "expectedOrchestratorCount": 0,        "contributingOrchestratorCount": 0,        "sumFinalShare": 0,        "computedAt": "2019-08-24T14:15:22Z",        "previousSnapshotId": "2ed775d1-8480-462f-b760-348e9c185eed",        "correctionReason": "verified_evidence_updated",        "revision": 0      }    }  ]}

Decentralized distributed bandwidth infrastructure.