--- title: "List User Physical Documents" method: GET path: "/users/{userID}/documents" tags: ["Physical Documents"] --- # List User Physical Documents `GET /users/{userID}/documents` Retrieves a list of Users Physical Documents by userID. ## Path parameters - `userID` string, required ## Response `200` Retrieving a list of Users Physical Documents by userID was Successful. - Documents[] — An array of uploaded documents - `documents` union[] — The personal identifiable information & digital signatures that will be updated. - union - BasicInfoOptional - `type` string, required - `data` object, required - `firstName` string — The first name of the User. - `lastName` string — The last (family) name of the User. - `country` string — The country where the User is residing. - `phone` string — The phone number of the User. - `emailAddress` string — The email address of the User. - IdentificationInfoOptional - `type` string, required - `data` object, required - `value` string — The User's national identification number or tax identification number. - `type` 'SSN' | 'EIN' | 'FTIN' | 'PASSPORT' | 'ALIEN_ID' | 'OTHER' — The type of national identification number. **Note:** `FTNLO` is deprecated and should not be used for new integrations. - `citizenship` string — The country where the User has citizenship. - `issuingCountry` string — The user's country. - `issuingProvince` string — The user's current state/province/territory, where they live. - `issueDate` string - `expiryDate` string - `description` string — Additional information about the identification type provided. - TaxInfoOptional - `type` string - `data` object - `taxTreatyWithUS` boolean — True, if the user lives in a treaty country and is claiming tax treaty with the United States. - PersonalInfoOptional - `type` string, required - `data` object, required - `birthDay` number — The User's born day. - `birthMonth` number — The User's born month. - `birthYear` number — The User's born year. - `dateOfDeath` string — The User's date of death in YYYY-MM-DD format. - `politicallyExposedNames` string — The names of the people whom are politicaly exposes, separated by a comma. *⚠️ Can be set to 'NULL' if not politically exposed* - `marital` 'SINGLE' | 'DIVORCED' | 'MARRIED' | 'WIDOWED' | 'PARTNER' — The marital status of the User. - AddressInfoOptional - `type` string, required - `data` object, required - `street1` string — The User's current street address, where they live. - `street2` string — The User's additional details of an address i.e. an apartment number. - `city` string — The User's current city, where they live. - `province` string — The User's current state/province/territory, where they live. - `postalCode` string — The User's current postal code (zip code). - `country` string — The User's current country, where they live. - EmploymentInfoOptional - `type` string, required - `data` object, required - `status` 'EMPLOYED' | 'RETIRED' | 'STUDENT' | 'UNEMPLOYED' | 'SELF_EMPLOYED' — The User's current employment status. - `company` string — The User's current employer name. *⚠️ Only required when status equal to EMPLOYED or SELF_EMPLOYED & type is not being provided* - `companyID` string — A unique identifier created for each Institution or entity on DriveWealth's platform.* - `from` string — The User's start date at the employment. - `to` string — The User's end date at the employment. - `type` 'AGRICULTURE' | 'MINING' | 'UTILITIES' | 'CONSTRUCTION' | 'MANUFACTURING' | 'WHOLESALE' | 'RETAIL' | 'TRANSPORT' | 'INFORMATION' | 'FINANCE' | 'REAL_ESTATE' | 'PROFESSIONAL' | 'MANAGEMENT' | 'EDUCATION' | 'HEALTH' | 'ART' | 'FOOD' | 'PUBLIC' | 'WASTE' — The User's current employer type. *⚠️ Only required when status equal to EMPLOYED or SELF_EMPLOYED & company is not being provided* - `position` 'ACCOUNTANT' | 'ACTUARY' | 'ADJUSTER' | 'ADMINISTRATOR' | 'ADVERTISER' | 'AGENT' | 'ATC' | 'AMBASSADOR' | 'ANALYST' | 'APPRAISER' | 'ARCHITECT' | 'ARTIST' | 'ASSISTANT' | 'ATHLETE' | 'ATTENDANT' | 'ATTORNEY' | 'AUCTIONEER' | 'AUDITOR' | 'BARBER' | 'BROKER' | 'BUSINESS_EXEC' | 'BUSINESS_OWNER' | 'CAREGIVER' | 'CARPENTER' | 'CASHIER' | 'CHEF' | 'CHIROPRACTOR' | 'CIVIL' | 'CLERGY' | 'CLERK' | 'COMPLIANCE' | 'CONSULTANT' | 'CONTRACTOR' | 'COUNSELOR' | 'CUSTOMER_SERVICE' | 'DEALER' | 'DEVELOPER' | 'DISTRIBUTOR' | 'DOCTOR' | 'DRIVER' | 'ENGINEER' | 'EXAMINER' | 'EXTERMINATOR' | 'FACTORY' | 'FARMER' | 'FINANCIAL' | 'FISHERMAN' | 'FLIGHT' | 'HR' | 'IMPEX' | 'INSPECTOR' | 'INTERN' | 'INVESTMENT' | 'INVESTOR' | 'IT' | 'JANITOR' | 'JEWELER' | 'LABORER' | 'LANDSCAPER' | 'LENDING' | 'MANAGER' | 'MECHANIC' | 'MILITARY' | 'MORTICIAN' | 'NURSE' | 'NUTRITIONIST' | 'OFFICE' | 'PHARMACIST' | 'PHYSICAL' | 'PILOT' | 'POLICE' | 'POLITICIAN' | 'PM' | 'REP' | 'RESEARCHER' | 'SAILOR' | 'SALES' | 'SCIENTIST' | 'SEAMSTRESS' | 'SECURITY' | 'SOCIAL' | 'TEACHER' | 'TECHNICIAN' | 'TELLER' | 'TRADESPERSON' | 'TRAINER' | 'TRANSPORTER' | 'UNDERWRITER' | 'WRITER' — The User's current role at the employment. *⚠️ Only required when staus equal to EMPLOYED or SELF_EMPLOYED & using Drivewealth's Market Data Offering* - `broker` boolean — True, if the User's current employer is broker.*⚠️ Only required when staus equal to EMPLOYED or SELF_EMPLOYED* - `directorOf` string — The company name, ticker of the company; if the user is a director or owns more than 10% of a publicly traded company. *⚠️ Can be set to 'NULL' if not applicable* - InvestorProfileInfoOptional - `type` string, required - `data` object, required - `investmentExperience` 'NONE' | 'YRS_1_LESS' | 'YRS_1_2' | 'YRS_3_5' | 'YRS_5_10' | 'YRS_10_' — The User's current investment expertise. *⚠️ Can be defaulted to 'YRS_1_2' for all asset classes, except Options.* - `annualIncome` number — The User's current annalized income over one year. - `networthTotal` number — The user's current networth. This calculation is the User's assets - liabilities. - `riskTolerance` 'LOW' | 'MODERATE' | 'HIGH' | 'SPECULATION' — The User's risk ceiling. *⚠️ Can be defaulted to 'LOW' for all asset classes, except Options.* - `investmentObjectives` 'LONG_TERM' | 'INFREQUENT' | 'FREQUENT' | 'ACTIVE_DAILY' | 'NEW' | 'CAPITAL_PRESERVATION' | 'GROWTH' | 'INCOME' | 'SPECULATION' — The User's current investment objectives. *⚠️ Can be defaulted to 'CAPITAL_PRESERVATION' for all asset classes, except Options.* - `secondaryInvestmentObjectives` string[] — The User's secondary investment objectives. - `networthLiquid` number — The user's liquid net worth. The amount of cash or near cash equivalents of the User's net worth. *⚠️ Can be defaulted to '-1' for all asset classes, except Options.* - `dependents` number — Total number of dependents the account holder has. *⚠️ Required for Options Onboarding.* - `suitabilityEquities` InvestmentSuitability - `experience` 'LIMITED' | 'NONE' | 'GOOD' | 'EXCELLENT' — Trading experience level. - `years` 'YRS_1_LESS' | 'YRS_1_2' | 'YRS_3_5' | 'YRS_6_9' | 'YRS_10_PLUS' — Number of years equity trading experience. - `tradesPerYear` 'YRS_0_9' | 'YRS_10_14' | 'YRS_15_24' | 'YRS_25_74' | 'YRS_75_PLUS' — Total number of trades per year. - `averageTradeSize` 'AVG_0_9999' | 'AVG_10000_24999' | 'AVG_25000_PLUS' — Average per trade size. - `suitabilityOptions` InvestmentSuitability - `experience` 'LIMITED' | 'NONE' | 'GOOD' | 'EXCELLENT' — Trading experience level. - `years` 'YRS_1_LESS' | 'YRS_1_2' | 'YRS_3_5' | 'YRS_6_9' | 'YRS_10_PLUS' — Number of years equity trading experience. - `tradesPerYear` 'YRS_0_9' | 'YRS_10_14' | 'YRS_15_24' | 'YRS_25_74' | 'YRS_75_PLUS' — Total number of trades per year. - `averageTradeSize` 'AVG_0_9999' | 'AVG_10000_24999' | 'AVG_25000_PLUS' — Average per trade size. - `equitiesExperience` InvestmentSuitabilityEquities - `knowledge` 'LIMITED' | 'NONE' | 'GOOD' | 'EXCELLENT' — Trading experience level. - `yearsOfExperience` number — Number of years of trading experience. - `tradesPerYear` number — Total number of trades per year. - `averageTradeValue` number — Average USD value per trade. - `transactionTypes` string[] — The types of transactions the user has experience with. - `optionsExperience` InvestmentSuitabilityOptions - `knowledge` 'LIMITED' | 'NONE' | 'GOOD' | 'EXCELLENT' — Trading experience level. - `yearsOfExperience` number — Number of years of trading experience. - `tradesPerYear` number — Total number of trades per year. - `averageTradeValue` number — Average USD value per trade. - `transactionTypes` string[] — The types of transactions the user has experience with. - `fixedIncomeExperience` union - object - … - object - … - `commodityExperience` union - object - … - object - … - `otherFinancialExperience` union - object - … - object - … - DisclosuresOptional - `type` string, required - `data` object, required - `extendedHoursAgreement` boolean — The User accepts DriveWealth's Extended Hours Agreement. - `termsOfUse` boolean — The User accepts DriveWealth's Terms of Use. - `customerAgreement` boolean — The User accepts DriveWealth's Customer Agreement. *⚠ Only for opening regular brokerage accounts.* - `iraAgreement` boolean — The User accepts DriveWealth's Individual Retirement Account (IRA) Agreement. *⚠ Only for opening IRA accounts.* - `marginAgreement` boolean — The User accepts DriveWealth's Margin Agreement. *⚠ Only for opening Margin (leveraged) accounts.* - `cryptoAgreements` boolean — The User accepts DriveWealth's Digital Assets Agreement. *⚠ Only for opening Digital Assets accounts.* - `marketDataAgreement` boolean — The User accepts DriveWealth's Market Data Agreement. - `optionsAgreement` boolean — True, if the User accepts DriveWealth's Options trading Agreement. - `oddLinkAgreement` boolean — True, if the User accepts DriveWealth's ODD Link Agreement. - `rule14b` boolean — The User accepts DriveWealth's Rule 14b1(c). - `privacyPolicy` boolean — The User accepts DriveWealth's Privacy Policy. - `dataSharing` boolean — The User accepts DriveWealth's Data Sharing Policy. - `signedBy` string — The User's digital signature (full name). - DirectorInfo - `type` string - `data` object - `directorList` Directors[] - `title` string — The title of the director. - `controlContact` boolean — True, if the director has control over the account. - `institutionalID` string — The unique identifier of the institution director should assioacted with.. - `roles` string[] - `percentage` number — The percentage of ownership the director has in the institution. Value must be greater than 0 and up to 1 (representing 0-100%), with a maximum of 2 decimal places. --- [API](https://skmtc.net/drivewealth/apis/authentication-apis.md) · [All operations](https://skmtc.net/drivewealth/apis/authentication-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/drivewealth/authentication-apis/revisions/9fced6d0ac41/schema)