GET 
/track-and-trace/v1/documents/:documentId

Gets the document corresponding to the ID.

Request

Path Parameters

documentId stringrequired
The 32-bytes ID of the document, encoded in hexadecimal.
Example: 0xbfc90433cfe7cf69119899a96837032bee6c84ba7f6ac9aa008ef2de5eeacfb8

Responses

200

Success

application/json

Schema

Schema

metadata string

Document's metadata

timestamp object

Timestamp object

datetime string

The date and time, optionally from transaction input

source string

Defines how the datetime was resolved, enumerated options are "block" and "external"

proof string

Proof of the source. Either a block number or a hash of timestamp certificate

events string[]

List of event hashes

creator string

The

did:key

or

did:ebsi

that created the document

Example

{
  "metadata": "metadata",
  "timestamp": {
    "datetime": "0x65b24e0d",
    "source": "block",
    "proof": "0x0000000000000000000000000000000000000000000000000000000000000006"
  },
  "events": [],
  "creator": "did:ebsi:ztqWJAmfyuUEf9Jvh97p167"
}

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.

Invalid {documentId} Parameter

{
  "title": "Bad Request",
  "status": 400,
  "detail": "[\"documentId must be 32 bytes encoded in hexadecimal and start with 0x\"]"
}

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.

Document 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.

Internal Server Error

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

Loading...