createParty

POST https://api-sandboxdash.norcapsecurities.com/tapiv3/index.php/v3/createParty

This method is used to create an individual Party in Transact API. This method will return the 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	yes	conditional	Is the party a U.S. Citizen, U.S. Resident, or non-resident
firstName	yes	string	Party's First Name
middleInitial	no	string	Party's Middle Initial
lastName	yes	string	Party's Last Name
socialSecurityNumber	no	string	The Party's Full SSN ( xxx-xx-xxxx )
dob	yes	string	The Party's Date of Birth (MM-DD-YYYY)
primCountry	yes	string	The country in which the Party's physical address resides
primAddress1	yes	string	The Party's physical address, line 1
primAddress2	no	string	The Party's physical address, line 2
primCity	yes	string	The city of the Party's physical address
primState	yes	string	The state in which the party’s primary residence is located (must be two letter abbreviated form). Use the value “NOUS” for addresses outside the United States.
primZip	yes	string	Zip code
emailAddress	yes	string	Party's contact email address
emailAddress2	no	string	Party's contact email address
phone	no	integer	Party's contact phone number
phone2	no	integer	Party's contact phone number
occupation	no	string	Party's occupation
associatedPerson	no	conditional	Yes or No - Is the party associated with a broker dealer?
empCountry	no	string	Employer country
empAddress1	no	string	Employer address 1
empAddress2	no	string	Employer address 2
empCity	no	string	Employer city
empState	no	string	Employer state
empZip	no	string	Employer zip
empName	no	string	Employer name
currentAnnIncome	no	integer	Party's current annual income
avgAnnIncome	no	integer	Party's average income over the past 2 years
currentHouseholdIncome	no	integer	Party's household income
avgHouseholdIncome	no	integer	Party's average household income
householdNetworth	no	integer	Household net worth
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, comma separated. Generally completed in the Admin interface or with question-based tag generation
createdIpAddress	no	string	IP Address associated with the createParty method call
notes	no	string	Free form text for any notes that need to be added to the party
empStatus	no	conditional	Select any one employee status.(eg: Employed, Not Employed, Retired, Student)
field1	no	string	Additional information relating to the party. Custom Field 1
field2	no	string	Additional information relating to the party. Custom Field 2
field3	no	string	Additional information relating to the party. Custom Field 3
invest_to	no	conditional	0 - I will be investing for myself 1 - I will be investing on behalf of another person or entity"

Sample Request

cURL

curl -k -X PUT https://api-sandboxdash.norcapsecurities.com/tapiv3/index.php/v3/createParty
 -d developerAPIKey=somedeveloperkey
 -d clientID=someclientid
 -d domicile=U.S. citizen
 -d firstName=John
 -d middleInitial=D
 -d lastName=Smith
 -d socialSecurityNumber=112-22-3333
 -d dob=28-02-1975
 -d primCountry=USA
 -d primAddress1=PEACHTREE PLACE
 -d primAddress2=TREE PLACE
 -d primCity=Atlanta
 -d primState=GA
 -d primZip=30318
 -d [email protected]
 -d emailAddress2=PEACHTREE PLACE
 -d phone=11223364585
 -d phone2=9876543210
 -d occupation=Developer
 -d associatedPerson=Yes
 -d invest_to=0
 -d empStatus=Employed
 -d empCountry=USA
 -d empName=Name
 -d empAddress1=PEACHTREE PLACE
 -d empAddress2=PEACHTREE PLACE
 -d empCity=Atlanta
 -d empState=GA
 -d empZip=30318
 -d currentAnnIncome=200000
 -d avgAnnIncome=200000
 -d currentHouseholdIncome=200000
 -d avgHouseholdIncome=200000
 -d householdNetworth=200000
 -d KYCstatus=pending
 -d AMLstatus=pending
 -d AMLdate=02-15-2016
 -d tags=tags
 -d field1=some text
 -d field2=some text
 -d field3=some text
 -d createdIpAddress=10.0.0.111
 -d notes=Notes Added

Response Parameters

Parameter	Type	Description
statusCode	string	API Status Code
statusDesc	string	API Status Description
partyDetails	array	The first value should be ignored. The second value is an array with one element, the new created by this request. See details below

partyDetails Parameters	Type	Description
partyId	string	Party ID that is generated by the API once an individual party is created (createParty)
KYCstatus	conditional	Know Your Customer(KYC) Status: Pending, Auto Approved, Manually Approved, Disapproved. Default status is "Pending"
AMLstatus	conditional	Anti-Money Laundering (AML) Status: Pending, Auto Approved, Manually Approved, Disapproved. Default status is "Pending"

Sample Response

{
    "statusCode": "101",
    "statusDesc": "Ok",
    "partyDetails": [
        true,
        [
            {
                "partyId": "P2726178",
                "KYCstatus": null,
                "AMLstatus": null
            }
        ]
    ]
}

Test it Yourself!