Skip to main content
API docs by Redocly

#trstd <protocol> - Transparency Log API (experimental) (0.0.0-experimental)

Download OpenAPI specification:Download

URL: https://example.org License: Apache-2.0

Experimental transparency log endpoints for the #trstd . These endpoints are non-normative and MUST NOT be implemented today. The design captures the intended direction for public auditability but carries no requirements until the trust model, Merkle tree construction, and consistency proof mechanisms are fully specified.

Get the latest transparency log head

Returns the current Merkle tree root hash and tree size.

Responses

Response samples

Content type
application/json
{
  • "treeSize": 48231,
  • "rootHash": "a3f2b8c1d4e5f6...",
  • "hashAlgorithm": "sha-256",
  • "timestamp": "2026-03-20T11:00:00Z"
}

Get transparency log entries

Returns log entries within the specified index range.

query Parameters
start
required
integer >= 0

Start index (inclusive)

end
required
integer >= 0

End index (exclusive)

Responses

Response samples

Content type
application/json
{
  • "entries": [
    ]
}

Get a Merkle inclusion proof

Returns an inclusion proof for the log entry identified by its canonical response hash.

path Parameters
responseHash
required
string

Hash of the canonical (JCS) response body (hex-encoded)

query Parameters
hashAlgorithm
string or null
Default: "sha-256"

Hash algorithm used (IANA Hash Function Textual Names registry). Defaults to sha-256.

treeSize
required
integer >= 1

Tree size to compute the proof against

Responses

Response samples

Content type
application/json
{
  • "leafIndex": 0,
  • "treeSize": 0,
  • "hashes": [
    ],
  • "hashAlgorithm": "sha-256"
}

Look up log entry by response ID

Returns the log entry for a specific verify response, including the responseHash.

path Parameters
responseId
required
string <uuid>
Example: f47ac10b-58cc-4372-a567-0e02b2c3d479

UUID of the verify response to look up

Responses

Response samples

Content type
application/json
{
  • "responseId": "ed662de2-39c1-4e7d-a6bf-6980511adfaf",
  • "responseHash": "a3f2b8c1d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0",
  • "hashAlgorithm": "sha-256",
  • "timestamp": "2019-08-24T14:15:22Z"
}

Get full response data by response ID

Returns the full response body (excluding the signature field) as stored at issuance time. Requires authentication.

Authorizations:
didWebJwt
path Parameters
responseId
required
string <uuid>
Example: f47ac10b-58cc-4372-a567-0e02b2c3d479

UUID of the verify response to look up

Responses

Response samples

Content type
application/json
{
  • "responseId": "ed662de2-39c1-4e7d-a6bf-6980511adfaf",
  • "responseHash": "string",
  • "hashAlgorithm": "sha-256",
  • "responseData": { },
  • "timestamp": "2019-08-24T14:15:22Z"
}