put https://api-sandboxdash.norcapsecurities.com/tapiv3/index.php/v3/updateSuitability
This method is used to update investment suitability information for an account (createAccount)
Request Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| clientID | yes | string | Transact API Client ID |
| developerAPIKey | yes | string | Transact API Developer Key |
| accountId | yes | integer | Account ID that is generated by the API once an account is created(createAccount) |
| riskProfile | no | conditional | Risk Profile Score: 1,2,3,4,5 (1=very conservative; 5=very aggressive) |
| investmentExperience | no | conditional | Investment Experience Score: 1,2,3,4,5 (1=none; 5=extensive) |
| privOffExperience | no | conditional | Experience Investing in Private Offerings Score: 1,2,3,4,5 (1=none; 5=extensive) |
| pctPrivSecurities | no | integer | Percentage of the Investor's Investment Portfolio that is invested in Private Placements |
| pctIlliquidSecurities | no | integer | Percentage of the Investor's Investment Portfolio that is invested in Illiquid Securities |
| pctLiquidSecurities | no | integer | Percentage of the Investor's Investment Portfolio that is invested in Liquid Securities |
| pctRealEstate | no | integer | Percentage of the Investor's Investment Portfolio that is invested in Real Estate |
| timeHorizon | no | conditional | The number of years until the investment portfolio is expected to reach maturity |
| education | no | conditional | Investor's Highest level of education: High School or GED, 4 Year College or University, Graduate Degree, Other |
| financialAdvisor | no | string | Yes or No. Does the Investor have a financial advisor? |
| notes | no | string | Free form text for any notes that need to be added for the suitability |
| invesmentObjective | no | string | Primarily on Capital Preservation,Both Capital Preservation and Growth,Primarily Focused on growth |
| additionalnotes | no | string | Primarily on Capital Preservation,Both Capital Preservation and Growth,Primarily Focused on growth |
Sample Request
curl -k -X PUT https://api-sandboxdash.norcapsecurities.com/tapiv3/index.php/v3/updateSuitability
-d clientID=someclientid
-d developerAPIKey=somedeveloperkey
-d accountId=A55473
-d riskProfile=1
-d investmentExperience=1
-d investmentObjective=Both Capital Preservation and Growth
-d privOffExperience=1
-d pctPrivSecurities=5
-d pctIlliquidSecurities=4
-d pctLiquidSecurities=4
-d pctRealEstate=6
-d timeHorizon=4
-d education=High School or GED
-d financialAdvisor=yes
-d notes=Suitability for an account
-d additionalnotes=Suitability for an account
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| statusCode | string | API Status Code |
| statusDesc | string | API Status Description |
| accountId | string | Unique identifier code for the account |
Sample Response
{
"statusCode": "101",
"statusDesc": "Ok",
"accountDetails": [{
"accountId": "A55473"
}]
}