Endorse Ownership

post

https://api.blockpeer.finance/api/blockpeer-trade/transfer/endorseOwnership

Endorse ownership of the electronic trade document to another party. Ownership endorsement represents a change in legal ownership, not just possession.

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..." }

Notes

Ownership endorsement is a legally significant action
Requires explicit End User approval
Integrating System should gate this action carefully

This API returns a URL with sessionId.
Use GET /auth/session-response?sessionId=<sessionId> to retrieve the session result.

Responses

File Upload Format (Base64 Data URI)

Notes

200The endorsement process has been initiated successfully. The response contains a redirect URL that must be opened for authentication and signing to finalize the endorsement.

400The request contains invalid or missing fields, or the authorization token was not supplied.

401The caller is not authorized to endorse ownership. This occurs if the caller is not the current holder on the Title Escrow contract.

409The endorsement request violates ownership rules or contract constraints, such as attempting endorsement when no nominee is set.

500Internal server error occurred during the endorsement initialization. This may include transaction preparation issues, blockchain read failures, or unexpected runtime errors.