Create Account

This method is used to create an account that can be linked (createLink) to an individual party (createParty) or an entity (createEntity).

Request Method : PUT

Request Parameters

Parameter Required Type Description
clientID yes string Transact API Client ID
developerAPIKey yes string Transact API Developer Key
accountRegistration yes string Investor Account Name - the exact registration of the account, such as "John Doe and Jane Doe JTWROS" or "John Doe IRA" or "Doe Family Trust"
type yes conditional Individual, Entity, TIC, JTWROS, IRA, SepIRA, ROTH,Joint
entityType no conditional Revocable Trust, Irrevocable Trust, Limited Partnership, LLC, Corporation
domesticYN yes conditional Domestic or International Account
streetAddress1 yes string Street Address Line 1
streetAddress2 no string Street Address Line 2
city yes string Account City
state yes string Account State (Optional for non-U.S. parties)
zip yes string Account Zip/Postal Code
country yes string Account Country
phone no integer Account Primary Phone Number
taxID no integer Account Tax ID Number
KYCstatus yes conditional Know Your Customer(KYC) Status: Pending, Auto Approved, Manually Approved, Disapproved. Default status is "Pending"
AMLstatus yes conditional Anti-Money Laundering(AML) Status: Pending, Auto Approved, Manually Approved, Disapproved. Default status is "Pending"
AMLdate no date Date of Anti-Money Laundering(AML) status update from the default "Pending" status.
suitabilityScore no integer Score from 1 to 5. 5 being most suitable and 1 being least suitable.
suitabilityDate no date Date that a Registered Representative(RR) approved the suitability for the account.
suitabilityApprover no string The name of the Registered Representative(RR) that approved the suitability for the account.
AccreditedStatus yes conditional The Accreditation Status for the Account: Pending, Self Accredited, Verified Accredited, Not Accredited. Default status is "Pending"
Allow no conditional Pending, Income, assets, all parties accredited
AIdate no date Date that the most recent accreditation review will expire.
506cLimit no integer Maximum total amount that can be invested in Regulation D 506(c) offerings from this account.
accountTotalLimit no integer Maximum total amount that can be invested from this account.
singleInvestmentLimit no integer Maximum amount that can be invested in a single investment for the account.
associatedAC no conditional Yes or No. Is the account associated with a broker dealer?
syndicate no conditional Yes or No. Generally completed in the Admin interface following a discussion with the Investor.
tags no string Up to 10 tags can be added to an account separated by commas. These are generally completed in the TAPI Admin interface or with question-based tag generation.
notes no string Free form text for any notes that need to be added to the account.
approvalStatus yes conditional Principal Approval Status: Pending, Approved, Not Approved
approvalPrincipal no string Name of Principal Reviewing the Account
approvalLastReview no date Date of previous accreditation review.
field1 no string Additional information relating to the account. Custom Field 1
field2 no string Additional information relating to the account. Custom Field 2
field3 no string Additional information relating to the account. Custom Field 3

Sample Request

curl -k -X PUT https://api.norcapsecurities.com/tapiv3/index.php/v3/createAccount
-d clientID=someclientid
-d developerAPIKey=somedeveloperkey
-d accountRegistration=John
-d type=Individual
-d entityType=Revocable Trust
-d domesticYN=domestic account
-d streetAddress1=First street
-d streetAddress2=Third avenue
-d city=ATLANTA
-d state=GA
-d zip=32526
-d country=USA
-d phone=41545218562
-d taxID=875451545875855
-d KYCstatus=pending
-d AMLstatus=pending
-d suitabilityScore=5
-d suitabilityDate=02-18-2016
-d suitabilityApprover=smith
-d AccreditedStatus=pending
-d AIlow=income
-d AIdate=02-18-2016
-d 506cLimit=50000
-d accountTotalLimit=200000
-d singleInvestmentLimit=100
-d associatedAC=yes
-d syndicate=no
-d tags=terms
-d notes=Personal Account
-d approvalStatus=pending
-d approvalPrincipal=Charles
-d approvalLastReview=02-15-2016
-d field1=some text
-d field2=some text
-d field3=some text

Response Parameters

Parameter Type Description
statusCode string API Status Code
statusDesc string API Status Description
accountId integer Unique identifier code for the Account

Sample Response

{
	"statusCode": "101",
	"statusDesc": "Ok",
	"accountDetails": [{
		"accountId": "A43256"
	}]
}
Click on the "Test it yourself" button to see how it works
Click on the "Error Codes" button to see list of error codes

Custodial Account