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

Gets the event corresponding to the document ID and event ID.

Request

Path Parameters

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

Responses

200

Success

application/json

Schema

Schema

metadata string

Event'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

sender string

The

did:key

or

did:ebsi

that created the event

origin string

Most of the times empty field, while it may be a string containing company name, while it can also point into an Event. All assumed relations are external to the SC.

hash string

Event hash

externalHash string

Externally generated hash

Example

{
  "externalHash": "0x7caebd56efed5cf6758c401961de9e33dff856cece64cb6ff3aa3a587393b96d",
  "hash": "0x4791c04d2e4838042c67f3e739ab8639b6bd0f6896ec7e32e99c640d43b530c7",
  "timestamp": {
    "datetime": "0x65d372cb",
    "source": "block",
    "proof": "0x000000000000000000000000000000000000000000000000000000000047a88d"
  },
  "sender": "did:ebsi:zxaYaUtb8pvoAtYNWbKcveg",
  "origin": "origin",
  "metadata": "eventMetadata"
}

400

Bad Request Error

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\"]"
}

Invalid {eventId} Parameter

{
  "title": "Bad Request",
  "status": 400,
  "detail": "[\"eventId 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"
}

Event Not Found

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

500

Internal Server Error

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.

Internal Server Error

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

Loading...