Users

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.

DocumentdocumentType
Power of Attorney (POA) FormPOAForm
Government IDId
Proof of AddressAddressVerificationFAFTA

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

post/customerApplication/submitpartnersubaccountdocument

Request

  • Base URL: https://demo.tradovateapi.com/v1
  • URL: https://demo.tradovateapi.com/v1/customerApplication/submitpartnersubaccountdocument
  • Auth: HTTP bearer

Request body

subAccountRequestIdinteger required
documentType'AMLBankStatement' | 'AMLOwnFundsLetter' | 'AccountReactivation' | 'AchOther' | 'AdditionalRiskDisclosure' | 'AddressChangeVerification' | 'AddressClarificationDocVsApplication' | 'AddressClarificationDocVsConfirmedAV' | 'AddressVerificationFAFTA' | 'AddressVerificationLLC' | 'AddressVerificationManagingMember' | 'AmendmentApprovingFuturesTrading' | 'AnnualIncomeAmount' | 'ApplicationAndIDNameMismatch' | 'ArticlesOfOrganization' | 'BankSupportingDocument' | 'BankruptcyDischargePaperwork' | 'BeneficialOwnerCertification' | 'CertificateOfGoodStanding' | 'CompanyFinancials' | 'ConfirmAccountInterest' | 'ConfirmAffiliations' | 'ConfirmFullName' | 'ConfirmIRACustodian' | 'ConfirmationOfDeposits' | 'CorporateBylaws' | 'CurrentBankStatement' | 'DrivingLicense' | 'EIN' | 'EVS' | 'EmployeeAttestationLetter' | 'EmploymentDetails' | 'EntityWebsite' | 'FullTimeTrader' | 'HedgeClarification' | 'HighRiskApplicant' | 'HomemakerIncome' | 'IRACustody' | 'Id' | 'InvestmentType' | 'LetterOfAwareness' | 'LiquidNetWorthAmount' | 'ManagingMemberId' | 'NFARegistrationConfirmation' | 'NatureOfEntity' | 'NatureOfSelfEmployment' | 'NetWorthAmount' | 'OfferingCircular' | 'OperatingAgreement' | 'Other' | 'OtherText' | 'OwnFunds' | 'POAForm' | 'POBox' | 'PartnershipDocuments' | 'Passport' | 'Professional' | 'ResidentialAddressConfirmation' | 'RetirementIncome' | 'SSNMiskey' | 'ShareholderRegister' | 'SocialSecurityCard' | 'SourceOfIncome' | 'SourceOfRiskCapital' | 'StatementOfGoodStanding' | 'StudentIncome' | 'ThirdPartyFunds' | 'TradingAuthorityPOA' | 'TrustDocuments' | 'UnderstandingOfFuturesTrading' | 'UnemployedIncome' | 'UtilityBill' | 'VerifyEmailAnotherName' | 'VerifyEmailOwnership' | 'VerifyEmailUsernameEntityWording' | 'VerifyEmailUsernameFinancialWording' | 'VerifyUsernameAnotherName' | 'Visa' | 'W8Clarification' | 'W8Incomplete' | 'W9' | 'YearsOfTradingExperience' | 'eSignBeneficialOwnerCertification' | 'eSignEmployeeAttestationLetter' | 'eSignMarketDataAgreement' | 'eSignW9' required

AMLBankStatement, AMLOwnFundsLetter, AccountReactivation, AchOther, AdditionalRiskDisclosure, AddressChangeVerification, AddressClarificationDocVsApplication, AddressClarificationDocVsConfirmedAV, AddressVerificationFAFTA, AddressVerificationLLC, AddressVerificationManagingMember, AmendmentApprovingFuturesTrading, AnnualIncomeAmount, ApplicationAndIDNameMismatch, ArticlesOfOrganization, BankSupportingDocument, BankruptcyDischargePaperwork, BeneficialOwnerCertification, CertificateOfGoodStanding, CompanyFinancials, ConfirmAccountInterest, ConfirmAffiliations, ConfirmFullName, ConfirmIRACustodian, ConfirmationOfDeposits, CorporateBylaws, CurrentBankStatement, DrivingLicense, EIN, EVS, EmployeeAttestationLetter, EmploymentDetails, EntityWebsite, FullTimeTrader, HedgeClarification, HighRiskApplicant, HomemakerIncome, IRACustody, Id, InvestmentType, LetterOfAwareness, LiquidNetWorthAmount, ManagingMemberId, NFARegistrationConfirmation, NatureOfEntity, NatureOfSelfEmployment, NetWorthAmount, OfferingCircular, OperatingAgreement, Other, OtherText, OwnFunds, POAForm, POBox, PartnershipDocuments, Passport, Professional, ResidentialAddressConfirmation, RetirementIncome, SSNMiskey, ShareholderRegister, SocialSecurityCard, SourceOfIncome, SourceOfRiskCapital, StatementOfGoodStanding, StudentIncome, ThirdPartyFunds, TradingAuthorityPOA, TrustDocuments, UnderstandingOfFuturesTrading, UnemployedIncome, UtilityBill, VerifyEmailAnotherName, VerifyEmailOwnership, VerifyEmailUsernameEntityWording, VerifyEmailUsernameFinancialWording, VerifyUsernameAnotherName, Visa, W8Clarification, W8Incomplete, W9, YearsOfTradingExperience, eSignBeneficialOwnerCertification, eSignEmployeeAttestationLetter, eSignMarketDataAgreement, eSignW9

filenamestring required
base64datastring required

Response

SubmitPartnerSubAccountDocumentResponse

errorTextstring

Non-empty if the request failed

documentIdinteger

Changes

No recorded changes to this operation across all 1 revision of this API.