Return ETR Back to the Issuer

Return the electronic trade document back to the original issuer.

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

Typically used upon:

  • Completion of trade
  • Settlement
  • Exception handling

Notes

  • Restores document control to issuer
  • Requires End User approval
  • Often the final lifecycle step

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

Body Params

Request payload for returning an endorsed trade record to its issuer

string
required
string
file
required

Upload a .json or .tt file

Headers
string

Unique key to ensure idempotency for API requests.

string

Unique external ID for tracking purposes, can be used for debugging and analytics.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json