GET/timestamp/v4/timestamps/:timestampId
Returns a timestamp identified by its ID.
Request
Path Parameters
- timestampId
Multihash of the sha256 of the original hash, encoded in multibase base64url.
timestampId = multibase_base64url(multihash(sha256(original_hash)))
Example: let's assume the original hash is a sha3-224 with the value
0xb2a8e000d1f25778cecf6b29fc0e7f811fb5f4a3a8230585e9056921
It is stored in the smart contract with the timestamp ID
0xb2a8e000d1f25778cecf6b29fc0e7f811fb5f4a3a8230585e9056921
The multihash representation of
0xb2a8e000d1f25778cecf6b29fc0e7f811fb5f4a3a8230585e9056921
EiCPQS4deZG8y1FXlG9sW1vDfMbpulXYTkn0HWj2OWd61A
At the API-level, the timestamp ID is then
uEiCPQS4deZG8y1FXlG9sW1vDfMbpulXYTkn0HWj2OWd61A
Description: Valid Conformance timestampId
Example: uEiBIzxkI4bvszQvBhBRAKnq5v6mGzocYtw1xUJasM0KDtw
Responses
- 200
- 400
- 404
- 500
Success
- application/json
- Schema
- Success
Schema
Timestamped hash (multi-hash, base64 multi-encoded)
Address of the transaction signer that timestamped the information.
Number of the block in which the hash has been timestamped.
Timestamp in ISO 8601 format
Hash of the transaction/transaction id.
Additional timestamp data (bytes, serialized JSON-LD)
{
"hash": "mFEBAhPl22Zo0z7AyMfbmD6mcAp2Ky+i9FJSI8RIan6gObbmGrUUszsI1gC5goLVusTpaaYmiPoUsdHPJRMHxSoj2",
"timestampedBy": "0x43dB818c99617668548909D77159750E15836C47",
"blockNumber": 2796212,
"timestamp": "2023-08-10T14:38:47.000Z",
"data": "0x7b2274657374223a34327d",
"transactionHash": "0xd6751fbc28e8a20b2ba696ababd44e430e17d91c482d287fd6d2472bdd08a590"
}
Bad Request
- application/problem+json
- Schema
- Invalid {timestampId} Parameter
Schema
Default value: about:blank
An absolute URI that identifies the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type.
A short summary of the problem type.
Possible values: >= 400 and <= 600
The HTTP status code generated by the origin server for this occurrence of the problem.
A human readable explanation specific to this occurrence of the problem.
An absolute URI that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
{
"title": "Bad Request",
"status": 400,
"detail": "The format of {timestampId} parameter is not valid"
}
Not found
- application/problem+json
- Schema
- Hash algorithm Not Found
Schema
Default value: about:blank
An absolute URI that identifies the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type.
A short summary of the problem type.
Possible values: >= 400 and <= 600
The HTTP status code generated by the origin server for this occurrence of the problem.
A human readable explanation specific to this occurrence of the problem.
An absolute URI that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
{
"title": "Not found",
"status": 404,
"detail": "Not found"
}
Internal Server Error
- application/json
- Schema
- Internal Server Error
Schema
Default value: about:blank
An absolute URI that identifies the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type.
A short summary of the problem type.
Possible values: >= 400 and <= 600
The HTTP status code generated by the origin server for this occurrence of the problem.
A human readable explanation specific to this occurrence of the problem.
An absolute URI that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
{
"title": "Internal error",
"status": 500,
"detail": "Internal error"
}