createEntity

This method is used to create an Entity Party in Transact API. This method will return the entity Party ID as a successful response.

Request Parameters

Parameter	Required	Type	Description
clientID	yes	string	TransactAPI Client ID
developerAPIKey	yes	string	TransactAPI Developer Key
domicile	no	conditional	U.S. citizen / U.S. resident / non-resident
entityName	yes	string	Name of the Entity
entityType	no	integer	Revocable Trust, Irrevocable Trust, Limited Partnership, LLC, Corporation
entityDesc	no	string	Description of the entity
ein	no	string	The entity's Employer Identification number (EIN) or Individual Social Security Number if applicable
primCountry	yes	string	The country in which the entity's primary physical address is located
primAddress1	yes	string	The entity's primary physical address, Line 1
primAddress2	no	string	The entity's primary physical address, Line 2
primCity	yes	string	The city in which the entity's primary physical address is located
primState	yes	string	The state ( must be two letter code only ) in which the entity's primary physical address is located. (It is optional for non-U.S. entities)
primZip	yes	string	The ZIP / postal code of the entity's primary physical address
emailAddress	yes	string	Entity party's primary email address
emailAddress2	no	string	Entity party's secondary email address
phone	no	integer	Entity party's primary phone number
phone2	no	integer	Entity party's secondary phone number
totalAssets	no	integer	Total amount of the entity's assets
ownersAI	no	conditional	Yes or No. Are the owners/members of the entity accredited investors?
KYCstatus	no	conditional	Know Your Customer(KYC) Status: Pending, Auto Approved, Manually Approved, Disapproved. Default status is "Pending"
AMLstatus	no	conditional	Anti-Money Laundering(AML) Status: Pending, Auto Approved, Manually Approved, Disapproved. Default status is "Pending"
AMLdate	no	string	Date of Anti-Money Laundering(AML) status update from the default "Pending" status
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
createdIpAddress	yes	string	IP Address associated with the createEntity method call
notes	no	string	Free form text for any notes that need to be added to the entity party
formationDate	no	date	Formation date for the entity

Sample Request

cURL

curl -k -X PUT https://api-sandboxdash.norcapsecurities.com/tapiv3/index.php/v3/createEntity
 -d developerAPIKey=somedeveloperkey
 -d clientID=someclientid
 -d domicile=U.S. citizen
 -d entityName=John
 -d entityType=LLC
 -d entityDesc=Description
 -d EIN=112223333
 -d primCountry=USA
 -d primAddress1=PEACHTREE PLACE
 -d primAddress2=PEACHTREE PLACE
 -d primCity=Atlanta
 -d primState=GA
 -d primZip=30318
 -d [email protected]
 -d [email protected]
 -d phone=11223364585
 -d phone2=565656565
 -d totalAssets=10c
 -d ownersAI=Yes
 -d KYCstatus=pending
 -d AMLstatus=pending
 -d AMLdate=03-15-2016
 -d tags=tags
 -d createdIpAddress=10.0.0.111
 -d notes=Notes Added
-d formationDate=07-25-2016

Response Parameters

Parameter	Type	Description
statusCode	string	API Status Code
statusDesc	string	API Status Description
partyId	integer	Unique identifier code for the entity party

Sample Response

{
  "statusCode": "101",
  "statusDesc": "Ok",
  "entityDetails": {
  "1": [
  {
  "partyId": "P12345"
  }
  ]
  }
 }

Test it Yourself!