Submit Partner Subaccount Document
Upload a document for a subaccount request.
Available to: Organization administrators
Environments: Production
Rate Limit: 10 requests per hour with 30-second back-off penalty
After creating a subaccount request, use this endpoint once per documentType to upload each of the three required documents.
| Document | documentType |
|---|---|
| Power of Attorney (POA) Form | POAForm |
| Government ID | Id |
| Proof of Address | AddressVerificationFAFTA |
<Warning>Warning: This endpoint returns HTTP 200 for successes and business errors. Always check the errorText field in the response body to determine whether the request succeeded or failed.</Warning>
subAccountRequestId
For subAccountRequestId, use the requestId returned from createpartnersubaccountrequest.
base64data Format
Documents are submitted inline as base64 data URIs. The base64data field must be a data URI with a supported MIME type prefix. The maximum field length is 8,388,608 characters (approximately 6 MB).
data:<mime-type>;base64,<base64-encoded-content>
Supported MIME types:
- application/pdf
- text/plain
- image/<file type> (for example, image/png or image/jpeg)
Size Limits
- Maximum request body: 5 MB
- Effective maximum file size: ~3.5 MB (base64 encoding adds ~33% overhead)
- Filename length: 5-64 characters
Re-upload Behavior
- Each document slot can only be filled once. The API rejects re-uploads to slots that already have a completed upload.
- If you uploaded the wrong document, contact Evaluation Support.
Common Failure Scenarios
- Invalid or non-existent subAccountRequestId
- Subaccount request is already Approved or Denied
- Invalid documentType value
- Missing or invalid data URI prefix in base64data
- Unsupported MIME type
- Document slot already has a completed upload
- Non-admin user attempting to call the endpoint
- Subaccount request belongs to a different organization
- POA contact not found on the subaccount request
Next Steps
After uploading all three documents, use the getpartnersubaccountrequeststatus endpoint to check the status of the subaccount request.
Request
- Base URL: https://demo.tradovateapi.com/v1
- URL: https://demo.tradovateapi.com/v1/customerApplication/submitpartnersubaccountdocument
- Auth: HTTP bearer
Request body
Response
SubmitPartnerSubAccountDocumentResponse
Changes
No recorded changes to this operation across all 1 revision of this API.