Call the ListTimeAnchors to get the anchor list of the ledger.

Request parameters

Parameter Type Required Example Description
Action String Required ListTimeAnchors

The operation that you want to perform. Valid values: ListTimeAnchors

LedgerId String Required l-c8cc7be3eea542axxxxxxxxxx

The ID of the ledger instance.

Reverse Boolean No false

The iteration direction. The default value is false, in which the creation time of a time anchor point is modified from the old to the new. If this parameter is set to true, the new anchor is updated to the original iteration based on the creation time.

NextToken String No xxx

Used to mark the current start reading position. If you set the parameter to Null, you must start reading data from the beginning.

MaxResults Integer Optional 100

The maximum amount of data to read. Default value: 10.

Response parameters

Parameter Type Example Description
MaxResults Integer 100

The maximum amount of data to read.

NextToken String xxxx

Returns the position where the data is read. Empty indicates that the data has been read.

RequestId String 89E6B5F5-7511-46A7-9EDB-3C6F8AA4D48C

The request ID.

TimeAnchors Array

The list of time anchors.

JournalId Long 57

The ID of the record.

LedgerDigest String 04d45eb3bcbd2a47aeb5de87b73fd6a324bb7b57a081fd474a82d8dc7e830d42868aeb15a9fa02ac09205b68ecfc78e8e67c70c67736aa0e867a9a7011b83fab4b

Ledger summary.

LedgerDigestType String SHA256

Ledger summary type.

LedgerVersion Long 57

The version of the ledger.

Proof String {"hashInHex":"de6eb06dfbbe534eedfdad435698d340f0dcba91b8bd4b76758317b00562daf6","sequence":49998}

Time evidence.

TimeStamp Long 1587515659

The timestamp when the value was obtained. Unit: second.

Examples

Sample requests

http(s)://[Endpoint]/? Action=ListTimeAnchors
&LedgerId=l-c8cc7be3eea542axxxxxxxxxx
&<Common request parameters>

Sample success responses

XML format

<TimeAnchors>
    <LedgerDigest>04d45eb3bcbd2a47aeb5de87b73fd6a324bb7b57a081fd474a82d8dc7e830d42868aeb15a9fa02ac09205b68ecfc78e8e67c70c67736aa0e867a9a7011b83fab4b</LedgerDigest>
    <JournalId>57</JournalId>
    <LedgerDigestType>SHA256</LedgerDigestType>
    <Proof>{"hashInHex":"de6eb06dfbbe534eedfdad435698d340f0dcba91b8bd4b76758317b00562daf6","sequence":49998}</Proof>
    <LedgerVersion>57</LedgerVersion>
    <TimeStamp>1587515659</TimeStamp>
</TimeAnchors>
<RequestId>89E6B5F5-7511-46A7-9EDB-3C6F8AA4D48C</RequestId>
<NextToken>xxxx</NextToken>
<MaxResults>100</MaxResults>

JSON format

{
    "TimeAnchors": {
        "LedgerDigest": "04d45eb3bcbd2a47aeb5de87b73fd6a324bb7b57a081fd474a82d8dc7e830d42868aeb15a9fa02ac09205b68ecfc78e8e67c70c67736aa0e867a9a7011b83fab4b",
        "JournalId": 57,
        "LedgerDigestType": "SHA256",
        "Proof": "{\"hashInHex\":\"de6eb06dfbbe534eedfdad435698d340f0dcba91b8bd4b76758317b00562daf6\",\"sequence\":49998}",
        "LedgerVersion": 57,
        "TimeStamp": 1587515659
    },
    "RequestId": "89E6B5F5-7511-46A7-9EDB-3C6F8AA4D48C",
    "NextToken": "xxxx",
    "MaxResults": 100
}

Error codes

HttpCode Error code Error message Description
400 InvalidParameter The specified parameter %s is invalid. The error message returned because the specified parameters are invalid.
400 MissingParameter You must specify the parameter %s. The error message returned when the client token is not specified.
404 ResourceNotFound The specified resource %s does not exist. Resource not found
403 UnauthorizedOperation You are not authorized to perform this operation. %s No operation permissions

For a list of error codes, visit the API Error Center.