Show Menu

Company Advanced Profile

This API calls allows your to fill and submit your or your connected company's Advanced Profile. There are 4 sections in the advanced profile. Business Entity Informations, Authorized Contact Information, Director Information, Ownership Information. If you are completing this form for a US company, you have to complete Business Entity Information and Authorized Contact Information rest of the sections are not required. If you are completing this form for a non US company, you have to complete all the four sections (Business entity, Authorized contact, Director and Ownership information).

post/API/v4/Profiles/CompanyAdvancedProfile

Header Parameters

Authorizationstring

bearer access_token

Content-typestring

application/json

Request Parameters for companys in US

IssuerAccountNumberstring

String length: inclusive between 1 and 25

FromAccountNumberstring

String length: inclusive between 1 and 25. Can be Issuer account number(SPNXXX) or Beneficiary company account number (SPNXXX)

Country_Of_Registration_Code2string

String length: 2. Use API/v4/Register/GetAdvancedContactCountry to get list of country.

Business Entity Information

Fictitious_NamestringFictitious Name/Doing Business As (DBA)

String length: inclusive between 1 and 255. Fictitious Name/Doing Business As (DBA)

Websitestring

String length: inclusive between 1 and 255.

Company_Typestring

String length: inclusive between 1 and 255. Use API/v4/Register/GetCompanyType to select from the list of company types.

Industry_Classificationstring

String length: inclusive between 1 and 255. Use API/v4/Register/GetNaics to select from the list of industry classification.

Date_Of_Registration

Region_Of_Incorporationstring

String length: inclusive between 1 and 255.

Country_Of_Registration_Code2string

String length: 2

Ticker_Symbolstring

String length: 1 and 2

Tax_Identification_Numberstring

String length: inclusive between 1 and 255.

Address_Line_1string

String length: inclusive between 1 and 255.

Address_Line_2string

String length: inclusive between 1 and 255.

Address_Line_3string

String length: inclusive between 1 and 255.

Citystring

String length: inclusive between 1 and 255.

Country_Code2string

String length: 2. Use API/v4/Register/GetAdvancedContactCountry to get list of country.

Region_Code2string

String length: 2. Use API/v4/Register/GetAdvancedContactState to get list of State/Region/County.

Postal_Codestring

String length: inclusive between 1 and 255.

Number_Of_Employeesint

Int length: 1 and 6

Expected_Monthly_Paymentsstring

Int length: 1 and 10.

Expected_Monthly_Volumestring

Int length: 1 and 10.

Purpose_Of_Paymentsstring

String length: inclusive between 1 and 255.

Countries_Sending_Payments_Tostring

String length: inclusive between 1 and 255.

Countries_Receiving_Payments_Fromstring

String length: inclusive between 1 and 255.

Authorized Contact Information

Job_Titlestring

String length: inclusive between 1 and 255. Use API/v4/Register/GetAdvancedContactJobTitles to get list of job titles.

First_Namestring

String length: inclusive between 1 and 255.

Middle_Namestring

String length: inclusive between 1 and 255.

Last_Namestring

String length: inclusive between 1 and 255.

Genderstring

String length: inclusive between 4 and 5.

Email_Addressstring

String length: inclusive between 1 and 200

Date_Of_BirthDate

Date: mm/dd/yyyy

Citizenshipstring

String length: inclusive between 1 and 255.

Identification_Typestring

String length: inclusive between 1 and 255. Use API/v4/Register/GetIdentificationType to get list of identification types.

Identification_Numberstring

String length: inclusive between 1 and 255.

Issue_DateDate

Date: mm/dd/yyyy

Expiration_DateDate

Date: mm/dd/yyyy

Issuing_Agencystring

String length: inclusive between 1 and 255.

Address_1string

String length: inclusive between 1 and 255.

Citystring

String length: inclusive between 1 and 255.

Region_Code2string

String length: 2. Use API/v4/Register/GetAdvancedContactState to get list of State/Region/County.

Country_Code2string

String length: 2. Use API/v4/Register/GetAdvancedContactCountry to get list of country.

Postal_Codestring

String length: inclusive between 1 and 255.

Business_Phonestring

SString length: inclusive between 1 and 255.

Reponse Parameters

Company Advanced Profile Responsestring

Returned if successful. Allowed parameters are
BeneficiaryID — Beneficiary Company or Issuer Account number for whom the advacened profile was completed.
Message — Advanced profile submission status

OperationStatusstring

Always returned Indicates the status of the operation. Allowed parameters are:
Errors - Displays an error message if the Property name Obligation Definition/value operation was unsuccessful. For more information, see API Error Message Appendix.
Success—Indicates whether the operation was successful. Returns True if the action was successful or False if it was not successful.

Request Parameters for companys Not in US

IssuerAccountNumberstring

String length: inclusive between 1 and 25

FromAccountNumberstring

String length: inclusive between 1 and 25. Can be Issuer account number(SPNXXX) or Beneficiary company account number (SPNXXX)

Country_Of_Registration_Code2string

String length: 2. String length: 2. Use API/v4/Register/GetAdvancedContactCountry to get list of country.

Business Entity Information

Fictitious_NamestringFictitious Name/Doing Business As (DBA)

String length: inclusive between 1 and 255. Fictitious Name/Doing Business As (DBA)

Websitestring

String length: inclusive between 1 and 255.

Company_Typestring

String length: inclusive between 1 and 255. Use API/v4/Register/GetCompanyType to select from the list of company types.

Industry_Classificationstring

String length: inclusive between 1 and 255. Use API/v4/Register/GetNaics to select from the list of industry classification.

Date_Of_Registrationdate

Date: mm/dd/yyyy

Region_Of_Incorporationstring

String length: inclusive between 1 and 255.

Ticker_Symbolstring

String length: 2

Tax_Identification_Numberstring

String length: inclusive between 1 and 255.

Address_Line_1string

String length: inclusive between 1 and 255.

Address_Line_2string

String length: inclusive between 1 and 255.

Address_Line_3string

String length: inclusive between 1 and 255.

Citystring

String length: inclusive between 1 and 255.

Country_Code2string

String length: 2. Use API/v4/Register/GetAdvancedContactCountry to get list of country.

Region_Code2string

String length: 2. Use API/v4/Register/GetAdvancedContactState to get list of State/Region/County.

Postal_Codestring

String length: inclusive between 1 and 255.

Number_Of_Employeesint

String length: inclusive between 1 and 6

Expected_Monthly_Paymentsint

String length: inclusive between 1 and 10

Expected_Monthly_Volumeint

String length: inclusive between 1 and 10

Purpose_Of_Paymentsstring

String length: inclusive between 1 and 255.

Countries_Sending_Payments_Tostring

String length: inclusive between 1 and 255.

Countries_Receiving_Payments_Fromstring

String length: inclusive between 1 and 255.

Authorized Contact Information

Job_Titlestring

String length: inclusive between 1 and 255. Use API/v4/Register/GetAdvancedContactJobTitles to get list of job titles.

First_Namestring

String length: inclusive between 1 and 255.

Middle_Namestring

String length: inclusive between 1 and 255.

Last_Namestring

String length: inclusive between 1 and 255.

Genderstring

String length: inclusive between 5 and 6

Email_Addressstring

String length: inclusive between 1 and 255.

Date_Of_Birthdate

Date: mm/dd/yyyy

Citizenshipstring

String length: inclusive between 1 and 255.

Identification_Typestring

String length: inclusive between 1 and 255. Use API/v4/Register/GetIdentificationType to get list of identification types.

Identification_Numberstring

String length: inclusive between 1 and 255.

Issue_Datedate

Date: mm/dd/yyyy

Expiration_Datedate

Date: mm/dd/yyyy

Issuing_Agencystring

String length: inclusive between 1 and 255.

Address_1string

String length: inclusive between 1 and 255.

Citystring

String length: inclusive between 1 and 255.

Region_Code2string

String length: 2. Use API/v4/Register/GetAdvancedContactState to get list of State/Region/County.

Country_Code2string

String length: 2. Use API/v4/Register/GetAdvancedContactCountry to get list of country.

Postal_Codestring

String length: inclusive between 1 and 255.

Business_Phonestring

String length: inclusive between 1 and 255.

Director Information - If you have more than one Director, repeat the entire section with Director_1_, Director_2_,Director_3_, etc.

Director_1_Job_Titlestring

String length: inclusive between 1 and 255. Use API/v4/Register/GetAdvancedContactJobTitles to get list of job titles.

Director_1_First_Namestring

String length: inclusive between 1 and 255.

Director_1_Last_Namestring

String length: inclusive between 1 and 255.

Director_1_Date_of_Birthstring

String length: inclusive between 1 and 255.

Director_1_Nationalitystring

String length: inclusive between 1 and 255.

Director_1_Identitification_Typestring

String length: inclusive between 1 and 255. Use API/v4/Register/GetIdentificationType to get list of identification types.

Director_1_Identity_Document_Numberstring

String length: inclusive between 1 and 255.

Director_1_Identity_Document_Expirationdate

Date: mm/dd/yyyy

Director_1_Jurisdictionstring

String length: inclusive between 1 and 255.

Director_1_Address_1string

String length: inclusive between 1 and 255.

Director_1_Citystring

String length: inclusive between 1 and 255.

Director_1_Country_Code2string

String length: 2. Use API/v4/Register/GetAdvancedContactCountry to get list of country.

Director_1_Region_Code2string

String length: 2. Use API/v4/Register/GetAdvancedContactState to get list of State/Region/County.

Director_1_Postal_Codestring

String length: inclusive between 1 and 255.

Ownership Information If you have more than one Owner, repeat the entire section with Owner_1_, Owner_2_,Owner_3_ etc.

Is_the_Company_Pubicly_Tradedstring

String length: true/false

Owner_1_Percentage_Ownedstring

String length: inclusive between 1 and 255.

Owner_1_First_Namestring

String length: inclusive between 1 and 255.

Owner_1_Last_Namestring

String length: inclusive between 1 and 255.

Owner_1_Occupationstring

String length: inclusive between 1 and 255.

Owner_1_Source_of_Incomestring

String length: inclusive between 1 and 255.

Owner_1_Date_of_Birthdate

Date: mm/dd/yyyy

Owner_1_Nationalitystring

String length: inclusive between 1 and 255.

Owner_1_Identity_Document_Typestring

String length: inclusive between 1 and 255. Use API/v4/Register/GetIdentificationType to get list of identification types.

Owner_1_Identity_Document_Numberstring

String length: inclusive between 1 and 255.

Owner_1_Jurisdictionstring

String length: inclusive between 1 and 255.

Owner_1_Address_1string

String length: inclusive between 1 and 255.

Owner_1_Citystring

String length: inclusive between 1 and 255.

Owner_1_Country_Code2string

String length: 2. Use API/v4/Register/GetAdvancedContactCountry to get list of country..

Owner_1_Region_Code2string

String length: 2. Use API/v4/Register/GetAdvancedContactState to get list of State/Region/County.

Owner_1_Postal_Codestring

String length: inclusive between 1 and 255.

Reponse Parameters

Company Advanced Profile Responsestring

Returned if successful. Allowed parameters are
BeneficiaryID — Beneficiary Company or Issuer Account number for whom the advacened profile was completed.
Message — Advanced profile submission status

OperationStatusstring

Always returned Indicates the status of the operation. Allowed parameters are:
Errors - Displays an error message if the Property name Obligation Definition/value operation was unsuccessful. For more information, see API Error Message Appendix.
Success—Indicates whether the operation was successful. Returns True if the action was successful or False if it was not successful.

Sample Request:

sandbox.xapi.xtrm.com/API/v4/Profiles/CompanyAdvancedProfile

{
	"AdvancedProfile":{
		"request":{
			"IssuerAccountNumber":"SPN Account Number",
			"BeneficiaryAccountNumber":"Beneficiary SPN Account Number",
            "Country_Of_Registration_Code2":"Use 'GetAdvancedContactCountry' to get Country",
			"BusinessEntityInformation":
				{
					"Legal_Company_Name":"Legal Company Name",
					"Fictitious_Name":"Fictitious Name",
                    "Website":"Website",
                    "Company_Type":"Company Type",
                    "Industry_Classification":"Use 'GetNAICS' to get NAICS",
                    "Date_Of_Registration":"Date Of Incorporation",
                    "Region_Of_Incorporation":"Subdivision Of Incorporation",
                    "Ticker_Symbol":"Ticker Symbol",
                    "Tax_Identification_Number":"Tax Identification Number",
                    "Address_Line_1":"Address Line 1",
                    "Address_Line_2":"Address Line 2",
                    "Address_Line_3":"Address Line 3",
                    "City":"City",
                    "Country_Code2":"Use 'GetAdvancedContactCountry' to get Country",
                    "Region_Code2":"Use 'GetAdvancedContactState' to get Region",
                    "Postal_Code":"Postal Code",
                    "Number_Of_Employees":"Number Of Employees",
                    "Expected_Monthly_Payments":"Expected Monthly Payments",
                    "Expected_Monthly_Volume":"Expected Monthly Volume",
                    "Purpose_Of_Payments":"Purpose Of Payments",
                    "Countries_Sending_Payments_To":"Countries Sending Payments To",
                    "Countries_Receiving_Payments_From":"Countries Receiving Payments From"
				},
			"AuthorizedContactInformation":
				{
					"Job_Title":"Use 'GetAdvancedContactJobTitles' to get Job Title",
                    "First_Name":"First Name",
                    "Middle_Name":"Middle Name",
                    "Last_Name":"Last Name",
                    "Gender":"Gender",
                    "Email_Address":"Primary Email Address",
                    "Date_Of_Birth":"Date Of Birth",
                    "Citizenship":"Citizenship",
                    "Identification_Type":"Identification Type",
                    "Identification_Number":"Identification Number",
                    "Issue_Date":"Identification Issue Date",
                    "Expiration_Date":"Identification Expiration Date",
                    "Issuing_Agency":"Use 'GetCompanyType' to get Issuing Agency",
                    "Address_1":"Contact Address 1",
                    "City":"Identification City",
                    "Region_Code2":"Use 'GetAdvancedContactState' to get Region",
                    "Country_Code2":"Use 'GetAdvancedContactCountry' to get Country",
                    "Postal_Code":"Contact Zip",
                    "Business_Phone":"Contact Business Phone"
				},
			"DirectorInformation":
				{
					"Director_1_Job_Title":"Director 1  Job Title",
                    "Director_1_First_Name":"Director 1  First Name",
                    "Director_1_Last_Name":"Director 1  Last Name",
                    "Director_1_Date_of_Birth":"Director 1  Date of Birth",
                    "Director_1_Nationality":"Use 'GetAdvancedContactCountry' to get Country",
                    "Director_1_Identification_Type":"Director 1  Identity Document Type",
                    "Director_1_Identity_Document_Number":"Director 1  Identity Document Number",
                    "Director_1_Identity_Document_Expiration":"Director 1  Identity Document Expiration",
                    "Director_1_Jurisdiction":"Director 1  Jurisdiction",
                    "Director_1_Address_1":"Director 1  Address 1",
                    "Director_1_City":"Director 1  City",
                    "Director_1_Country_Code2":"Use 'GetAdvancedContactCountry' to get Country",
                    "Director_1_Region_Code2":"Use 'GetAdvancedContactState' to get Region",
                    "Director_1_Postal_Code":"Director 1  Postal Code",
                    "Director_2_Job_Title":"Director 2  Job Title",
                    "Director_2_First_Name":"Director 2  First Name",
                    "Director_2_Last_Name":"Director 2  Last Name",
                    "Director_2_Date_of_Birth":"Director 2  Date of Birth",
                    "Director_2_Nationality":"Use 'GetAdvancedContactCountry' to get Country",
                    "Director_2_Identification_Type":"Director 2  Identity Document Type",
                    "Director_2_Identity_Document_Number":"Director 2  Identity Document Number",
                    "Director_2_Identity_Document_Expiration":"Director 2  Identity Document Expiration",
                    "Director_2_Jurisdiction":"Director 2  Jurisdiction",
                    "Director_2_Address_1":"Director 2  Address 1",
                    "Director_2_City":"Director 2  City",
                    "Director_2_Country_Code2":"Use 'GetAdvancedContactCountry' to get Country",
                    "Director_2_Region_Code2":"Use 'GetAdvancedContactState' to get Region",
                    "Director_2_Postal_Code":"Director 2  Postal Code",
                    "Director_3_Job_Title":"Director 3  Job Title",
                    "Director_3_First_Name":"Director 3  First Name",
                    "Director_3_Last_Name":"Director 3  Last Name",
                    "Director_3_Date_of_Birth":"Director 3  Date of Birth",
                    "Director_3_Nationality":"Director 3  Nationality",
                    "Director_3_Identification_Type":"Director 3  Identity Document Type",
                    "Director_3_Identity_Document_Number":"Director 3  Identity Document Number",
                    "Director_3_Identity_Document_Expiration":"Director 3  Identity Document Expiration",
                    "Director_3_Jurisdiction":"Director 3  Jurisdiction",
                    "Director_3_Address_1":"Director 3  Address 1",
                    "Director_3_City":"Director 3  City",
                    "Director_3_Country_Code2":"Use 'GetAdvancedContactCountry' to get Country",
                    "Director_3_Region_Code2":"Use 'GetAdvancedContactState' to get Region",
                    "Director_3_Postal_Code":"Director 3  Postal Code",
                    "Director_4_Job_Title":"Director 4  Job Title",
                    "Director_4_First_Name":"Director 4  First Name",
                    "Director_4_Last_Name":"Director 4  Last Name",
                    "Director_4_Date_of_Birth":"Director 4  Date of Birth",
                    "Director_4_Nationality":"Director 4  Nationality",
                    "Director_4_Identification_Type":"Director 4  Identity Document Type",
                    "Director_4_Identity_Document_Number":"Director 4  Identity Document Number",
                    "Director_4_Identity_Document_Expiration":"Director 4  Identity Document Expiration",
                    "Director_4_Jurisdiction":"Director 4  Jurisdiction",
                    "Director_4_Address_1":"Director 4  Address 1",
                    "Director_4_City":"Director 4  City",
                    "Director_4_Country_Code2":"Use 'GetAdvancedContactCountry' to get Country",
                    "Director_4_Region_Code2":"Use 'GetAdvancedContactState' to get Region",
                    "Director_4_Postal_Code":"Director 4  Postal Code",
                    "Director_5_Job_Title":"Director 5  Job Title",
                    "Director_5_First_Name":"Director 5  First Name",
                    "Director_5_Last_Name":"Director 5  Last Name",
                    "Director_5_Date_of_Birth":"Director 5  Date of Birth",
                    "Director_5_Nationality":"Use 'GetAdvancedContactCountry' to get Country",
                    "Director_5_Identification_Type":"Director 5  Identity Document Type",
                    "Director_5_Identity_Document_Number":"Director 5  Identity Document Number",
                    "Director_5_Identity_Document_Expiration":"Director 5  Identity Document Expiration",
                    "Director_5_Jurisdiction":"Director 5  Jurisdiction",
                    "Director_5_Address_1":"Director 5  Address 1",
                    "Director_5_City":"Director 5  City",
                    "Director_5_Country_Code2":"Use 'GetAdvancedContactState' to get Country",
                    "Director_5_Region_Code2":"Use 'GetAdvancedContactState' to get Region",
                    "Director_5_Postal_Code":"Director 5  Postal Code"
				},
			"OwnerInformation":
				{
					"Is_the_Company_Pubicly_Traded":"yes/no",
                    "Owner_1_Percentage_Owned":"Owner 1 Percentage Owned",
                    "Owner_1_First_Name":"Owner 1 First Name",
                    "Owner_1_Last_Name":"Owner 1 Last Name",
                    "Owner_1_Occupation":"Owner 1 Occupation",
                    "Owner_1_Source_of_Income":"Owner 1 Source of Income",
                    "Owner_1_Date_of_Birth":"Owner 1 Date of Birth",
                    "Owner_1_Nationality":"Owner 1 Nationality",
                    "Owner_1_Identity_Document_Type":"Owner 1 Identity Document Type",
                    "Owner_1_Identity_Document_Number":"Owner 1 Identity Document Number",
                    "Owner_1_Identity_Document_Expiration":"Owner 1 Identity Document Expiration",
                    "Owner_1_Jurisdiction":"Owner 1 Jurisdiction",
                    "Owner_1_Address_1":"Owner 1 Address 1",
                    "Owner_1_City":"Owner 1 City",
                    "Owner_1_Country_Code2":"Use 'GetAdvancedContactCountry' to get Country",
                    "Owner_1_Region_Code2":"Use 'GetAdvancedContactState' to get Region",
                    "Owner_1_Postal_Code":"Owner 1 Postal Code",
                    "Owner_2_Percentage_Owned":"Owner 2 Percentage Owned",
                    "Owner_2_First_Name":"Owner 2 First Name",
                    "Owner_2_Last_Name":"Owner 2 Last Name",
                    "Owner_2_Occupation":"Owner 2 Occupation",
                    "Owner_2_Source_of_Income":"Owner 2 Source of Income",
                    "Owner_2_Date_of_Birth":"Owner 2 Date of Birth",
                    "Owner_2_Nationality":"Owner 2 Nationality",
                    "Owner_2_Identity_Document_Type":"Owner 2 Identity Document Type",
                    "Owner_2_Identity_Document_Number":"Owner 2 Identity Document Number",
                    "Owner_2_Identity_Document_Expiration":"Owner 2 Identity Document Expiration",
                    "Owner_2_Jurisdiction":"Owner 2 Jurisdiction",
                    "Owner_2_Address_1":"Owner 2 Address 1",
                    "Owner_2_City":"Owner 2 City",
                    "Owner_2_Country_Code2":"Use 'GetAdvancedContactCountry' to get Country",
                    "Owner_2_Region_Code2":"Use 'GetAdvancedContactState' to get Region",
                    "Owner_2_Postal_Code":"Owner 2 Postal Code",
                    "Owner_3_Percentage_Owned":"Owner 3 Percentage Owned",
                    "Owner_3_First_Name":"Owner 3 First Name",
                    "Owner_3_Last_Name":"Owner 3 Last Name",
                    "Owner_3_Occupation":"Owner 3 Occupation",
                    "Owner_3_Source_of_Income":"Owner 3 Source of Income",
                    "Owner_3_Date_of_Birth":"Owner 3 Date of Birth",
                    "Owner_3_Nationality":"Owner 3 Nationality",
                    "Owner_3_Identity_Document_Type":"Owner 3 Identity Document Type",
                    "Owner_3_Identity_Document_Number":"Owner 3 Identity Document Number",
                    "Owner_3_Identity_Document_Expiration":"Owner 3 Identity Document Expiration",
                    "Owner_3_Jurisdiction":"Owner 3 Jurisdiction",
                    "Owner_3_Address_1":"Owner 3 Address 1",
                    "Owner_3_City":"Owner 3 City",
                    "Owner_3_Country_Code2":"Use 'GetAdvancedContactCountry' to get Country",
                    "Owner_3_Region_Code2":"Use 'GetAdvancedContactState' to get Region",
                    "Owner_3_Postal_Code":"Owner 3 Postal Code"
				}
		}
	}
}				

Sample Response:


{
	"AdvancedProfileResponse": {
		"AdvancedProfileResult": {
			"BeneficiaryID": "SPN19134717",
			"Message": "Advanced Profile Submitted Successfully",
			"OperationStatus": {
				"Success": true,
				"Errors": null
			}
		}
	}
}