Create Entity

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 Method : PUT

Request Parameters

Parameter Required Type Description
clientID yes string Transact API Client ID
developerAPIKey yes string Transact API Developer Key
domicile yes conditional U.S. citizen / U.S. resident / non-resident
entityName yes string Name of the Entity
entityType no conditional 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 integer 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 -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 emailAddress=john@gmail.com
 -d emailAddress2=smith@gmail.com
 -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"
  }
  ]
  }
 }
Click on the "Test it yourself" button to see how it works
Click on the "Error Codes" button to see list of error codes

Marketplace-as-a-Service