Set Customer Application (deprecated)
Submits a comprehensive customer application for either individual or corporate entities. This endpoint handles KYC (Know Your Customer), AML (Anti-Money Laundering), and investment profile data collection for customer onboarding and compliance purposes.
Endpoint
POST/v2/customer/{customerId}/application
Link
Request
Path Parameters
Parameter
Type
Description
Required
Example
customerId
string
Customer ID to submit application for.
Yes
"cust_12345"
Headers
Key
Value
Required
Authorization
Bearer <JWT>
Yes
Accept
application/json
Yes
Content-Type
application/json
Yes
Body Parameters
Important: Use either individual OR corporate object, not both.
Individual Application Structure
Individual Application Object
Field
Type
Description
Required
application
object
Main application data
Yes
Application Basic Information
Field
Type
Description
Required
firstName
string
Customer's first name
Yes
middleName
string
Customer's middle name
No
lastName
string
Customer's last name
Yes
emailAddress
string
Contact email address
Yes
mailingAddress
object
Mailing address details
Yes
telephoneNumber
string
Contact phone number
Yes
taxReferenceNumber
string
Tax ID/SSN
Yes
passportNumber
string
Passport number
Yes
nationality
string
Nationality/citizenship
Yes
dateOfBirth
string
Date of birth (ISO format)
Yes
usResidencyStatus
string
US residency status
Yes
employmentStatus
string
Current employment status
Yes
employmentDescription
string
Employment details
No
employerName
string
Employer name
No
occupation
string
Job title/occupation
Yes
Address Object
Field
Type
Description
Required
unitNumber
string
Unit/Apartment number
No
addressLine1
string
Primary address line
Yes
addressLine2
string
Secondary address line
No
addressLine3
string
Tertiary address line
No
city
string
City
Yes
stateIso
string
State/Province code
Yes
postalCode
string
ZIP/Postal code
Yes
countryIso
string
Country code
Yes
Investment Profile
Field
Type
Description
Required
primarySourceOfFunds
string
Main funding source
Yes
primarySourceOfFundsDescription
string
Funding source details
No
totalAssets
string
Total asset value range
Yes
usdValueOfFiat
string
Fiat currency holdings
Yes
monthlyDeposits
string
Monthly deposit frequency
Yes
monthlyWithdrawals
string
Monthly withdrawal frequency
Yes
monthlyInvestmentDeposit
string
Investment deposit amount
Yes
monthlyInvestmentWithdrawal
string
Investment withdrawal amount
Yes
usdValueOfCrypto
string
Crypto holdings value
Yes
monthlyCryptoDeposits
string
Crypto deposit frequency
Yes
monthlyCryptoWithdrawals
string
Crypto withdrawal frequency
Yes
monthlyCryptoInvestmentDeposit
string
Crypto investment deposits
Yes
monthlyCryptoInvestmentWithdrawal
string
Crypto investment withdrawals
Yes
KYC Profile
Field
Type
Description
Required
fundsSendReceiveJurisdictions
array[string]
Countries for fund transfers
Yes
engageInActivities
array[string]
Business activities
Yes
numberOfOperation
string
Monthly transaction count
Yes
aggregateUsdVolume1stMonth
string
Expected 1st month volume
Yes
aggregateUsdVolume3stMonth
string
Expected 3rd month volume
Yes
aggregateUsdVolume6stMonth
string
Expected 6th month volume
Yes
regulatedNoLicenseExplain
string
Regulatory explanation
No
requireClientAccount
boolean
Client account requirement
Yes
vendorsAndCounterparties
array[string]
Business counterparty types
Yes
Documents
Field
Type
Description
Required
documents
array[object]
Supporting documents
Yes
informationAttested
boolean
Information verification
Yes
guid
string
Application GUID
Yes
Corporate Application Structure
Corporate Application Object
Field
Type
Description
Required
application
object
Main corporate application
Yes
individuals
array[object]
Company representatives
Yes
Corporate Basic Information
Field
Type
Description
Required
registeredName
string
Legal company name
Yes
tradingName
string
Trading/business name
Yes
registeredNumber
string
Company registration number
Yes
registeredAddress
object
Legal registered address
Yes
physicalAddress
object
Physical business address
Yes
telephoneNumber
string
Business phone number
Yes
websiteAddress
string
Company website
No
stateOfIncorporation
string
State of incorporation
Yes
countryOfIncorporation
string
Country of incorporation
Yes
corporateEntityType
string
Business entity type
Yes
corporateEntityTypeDescription
string
Entity type details
No
emailAddress
string
Business email
Yes
establishedOn
string
Incorporation date
Yes
naics
string
NAICS code
Yes
naicsDescription
string
Business description
Yes
taxReferenceNumber
string
Business tax ID
Yes
legalStructureDescription
string
Legal structure details
No
Corporate Investment Profile
Field
Type
Description
Required
primarySourceOfFunds
string
Main funding source
Yes
totalInvestableAssets
string
Investable assets range
Yes
totalAssets
string
Total company assets
Yes
assetAllocationToCrypto
string
Crypto allocation
Yes
investmentExperienceCrypto
string
Crypto experience level
Yes
investmentStrategyCrypto
string
Investment strategy
Yes
initialDepositSource
string
Initial deposit method
Yes
ongoingDepositSource
string
Ongoing deposit method
Yes
frequencyOfCryptoTransactions
string
Crypto transaction frequency
Yes
cryptoInvestmentPlans
string
Crypto investment plans
Yes
tradesPerMonth
string
Monthly trade volume
Yes
tradeInternationally
boolean
International trading
Yes
Corporate KYC Profile
Field
Type
Description
Required
primaryBusiness
string
Primary business activity
Yes
descriptionOfBusinessNature
string
Business description
Yes
isCharitable
boolean
Charitable organization
Yes
businessJurisdictions
array[string]
Operating jurisdictions
Yes
regulatedStatus
string
Regulatory status
Yes
regulationAgency
string
Regulatory body
No
controlExemptionReason
string
Control exemption reason
Yes
Corporate Individuals
Field
Type
Description
Required
individualType
array[string]
Role types (Officer, Owner, etc.)
Yes
firstName, lastName
string
Personal details
Yes
percentageOwnership
integer
Ownership percentage
Yes
title
string
Job title
Yes
documents
array[object]
Personal documents
Yes
Error Responses
Invalid Customer ID:
json
Missing Required Fields:
json
Both Individual and Corporate Provided:
json
Unauthorized:
json
Notes
Oneof Requirement: Submit either individual OR corporate application, never both
Document Status: Documents can have statuses:
DST_SUBMITTED,DST_APPROVED,DST_REJECTED, etc.Compliance: All fields are used for regulatory compliance and KYC/AML purposes
Validation: Extensive validation is performed on all submitted data
Audit Trail: All applications are logged for compliance auditing
Common Use Cases:
New customer onboarding
KYC/AML compliance
Investment suitability assessment
Regulatory reporting
Risk management
Security Considerations:
Sensitive personal and financial information
Strict access controls
Data encryption in transit and at rest
Compliance with privacy regulations
Examples
Real request
json
Real respose
json
Last updated