This endpoint retrieves the current ownership roles associated with a document registered under a Title Escrow smart contract. It allows clients to obtain the authoritative and on-chain verified owner information for the specified document.
Upon receiving the request, the system identifies the document using the metadata embedded within the submitted file. This metadata includes a unique hash that represents the token on-chain. Using this token reference and the provided registry address, the system locates the corresponding Title Escrow contract instance.
The contract’s state is queried to extract the ownership structure, which typically includes roles such as the current holder, current beneficiary, and any nominee that may be assigned. These ownership roles represent the live state of the document on-chain and are essential for validation processes, transfer workflows, auditing, and user-facing informational displays.
This endpoint performs read-only operations and does not modify any on-chain or off-chain state. It solely provides the latest ownership information as recognized by the registry and Title Escrow contract.
The retrieved ownership data is returned in a structured response, allowing the caller to understand the current distribution of ownership roles for the document.
File Upload Format (Base64 Data URI)
For endpoints that accept file inputs, files must be submitted as a Base64-encoded Data URI string in the document field.
Format
data:<mimeType>;name=<filename>;base64,<base64EncodedContent>
Example
json
{ "document": "data:application/octet-stream;name=BL-0xd7.tt;base64,ewogICJAY29udGV4dCI6IFsKICAgICJodHRwcz..." }