GET 
/timestamp/v3/timestamps/:timestampId

Returns a timestamp identified by its ID.

Request

Path Parameters

timestampId stringrequired

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

, which corresponds to the sha256 of the original hash.

The multihash representation of

0xb2a8e000d1f25778cecf6b29fc0e7f811fb5f4a3a8230585e9056921

is

EiCPQS4deZG8y1FXlG9sW1vDfMbpulXYTkn0HWj2OWd61A

(encoded in base64url).

At the API-level, the timestamp ID is then

uEiCPQS4deZG8y1FXlG9sW1vDfMbpulXYTkn0HWj2OWd61A

, i.e. it's the multibase base64url (prefix "u") encoded multihash.

Examples:

timestampId

Description: Valid pilot timestampId

Example: uEiBrUuxV-ybYtSQ4oiczDhFkmUR7Wk6QtF26SXaD9h9RTg

Responses

200

Success

application/json

Schema

Schema

hash string

Timestamped hash (multi-hash, base64 multi-encoded)

timestampedBy string

Address of the transaction signer that timestamped the information.

blockNumber integer

Number of the block in which the hash has been timestamped.

timestamp string

Timestamp in ISO 8601 format

transactionHash string

Hash of the transaction/transaction id.

data string

Additional timestamp data (bytes, serialized JSON-LD)

Example (from schema)

{
  "hash": "string",
  "timestampedBy": "string",
  "blockNumber": 0,
  "timestamp": "string",
  "transactionHash": "string",
  "data": "string"
}

Success

{
  "hash": "mE0BoK9lFXyC8pGx0XW6O/VuO8WBLMlS7KLx2bah55YH/VhaorawVrWFr/hMnbgBpR3vNSx8tA0A6MxtNmqNwjHaR",
  "timestampedBy": "0xb8d511d80D9Cc1cFAfa79973edE37278d8B1ebd7",
  "blockNumber": 1880267,
  "timestamp": "2021-08-30T15:20:16.000Z",
  "data": "0x7b2274657374223a3734327d",
  "transactionHash": "0x125988a9a6a9a02da35981dee230e1900088ef7fc5064c1f1d2225ef2d2c53e6"
}

400

Bad Request

application/problem+json

Schema

Schema

type uri

Default value: about:blank

An absolute URI that identifies the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type.

title string

A short summary of the problem type.

status int32

Possible values: >= 400 and <= 600

The HTTP status code generated by the origin server for this occurrence of the problem.

detail string

A human readable explanation specific to this occurrence of the problem.

instance uri

An absolute URI that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

Example (from schema)

{
  "type": "about:blank",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "Connection timeout",
  "instance": "string"
}

Invalid {timestampId} Parameter

{
  "title": "Bad Request",
  "status": 400,
  "detail": "The format of {timestampId} parameter is not valid"
}

404

Not found

application/problem+json

Schema

Schema

type uri

Default value: about:blank

An absolute URI that identifies the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type.

title string

A short summary of the problem type.

status int32

Possible values: >= 400 and <= 600

The HTTP status code generated by the origin server for this occurrence of the problem.

detail string

A human readable explanation specific to this occurrence of the problem.

instance uri

An absolute URI that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

Example (from schema)

{
  "type": "about:blank",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "Connection timeout",
  "instance": "string"
}

Hash algorithm Not Found

{
  "title": "Not found",
  "status": 404,
  "detail": "Not found"
}

500

Internal Server Error

application/json

Schema

Schema

type uri

Default value: about:blank

An absolute URI that identifies the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type.

title string

A short summary of the problem type.

status int32

Possible values: >= 400 and <= 600

The HTTP status code generated by the origin server for this occurrence of the problem.

detail string

A human readable explanation specific to this occurrence of the problem.

instance uri

An absolute URI that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

Example (from schema)

{
  "type": "about:blank",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "Connection timeout",
  "instance": "string"
}

Internal Server Error

{
  "title": "Internal error",
  "status": 500,
  "detail": "Internal error"
}

Loading...