Core Functionality
The platform offers aPOST /v1/documents/email endpoint that enables sending documents directly to recipient inboxes. As described in the guide, this feature allows users to request statements, tax forms, or trade confirmations “without building a separate delivery pipeline.”
Request Parameters
The endpoint accepts two fields:- documentUrl (required): An HTTPS URL from the
/v1/documents/listresponse - email (optional): Recipient address; if omitted, the system uses the account holder’s registered email
Response Structure
Successful requests return a response object containing asuccessful boolean and an optional message field confirming dispatch or describing errors.
Error Handling
The documentation identifies several potential failure scenarios:- Invalid or malformed URLs trigger an
INVALID_DOCUMENT_URLerror - Improperly formatted email addresses generate an
INVALID_EMAILresponse - Missing or invalid API credentials result in
UNAUTHORIZEDstatus - Server-side processing failures return an
INTERNAL_ERROR