EmploymentDetails

  • Provide the Employment Details of the applicant if EmploymentType= SELFEMPLOYED OR EMPLOYED

  • Fully Disclosed Client (Individual, Joint, Retirement, Org, Trust)

  • Advisor Client (Individual, Joint, Retirement, Org, Trust)

  • OWD Client (Individual, Joint, Org, Trust)

  • Individual/Retirement: AccountHolder

  • Joint: FirstHolderDetails, SecondHolderDetails

  • Org: AssociatedIndividual

  • Trust: Individual

  • EmploymentType="EMPLOYED" OR "SELFEMPLOYED"

    • FA and FD clients with IBLLC, IB-IE, IB-CE, and IB-UK: Full employer_address (country, state, city, street_1, postal_code) is required

    • All other clients: country within employer_address is required.

  • If EmploymentType=“EMPLOYED"

    • employer_address cannot be the same as Residence OR MailingAddress. An error will be thrown IF street_1 for employer_address is the same as Residence/MailingAddress..

    • If the applicant works remotely, please provide the Legal Address of the Employer.

  • EmploymentType="SELFEMPLOYED"

    • employer_address can be the same as Residence OR MailingAddress.

  • EmploymentType="EMPLOYED" OR "SELFEMPLOYED"

    • When the country included within <Residence> node is different from the country included within <employer_address> node, THEN emplcountry_rescountry_details is required within the <EmploymentDetails> node.

XSD

Copy 
<xsd:complexType name="EmploymentDetails" use="Required IF EMPLOYED OR SELFEMPLOYED" minOccurs="0" maxOccurs="1" /> 
 <xsd:attribute name="is_duplicate_stmt_required" type="Boolean" use="Optional"  minOccurs="0" maxOccurs="1"  />
  <xsd:sequence>
   <xsd:element name="employer" type="String" use="Required"/> 
   <xsd:element name="occupation" type="description" use="Required IF other is provided as occupation OR employer_business"/> 
   <xsd:element name="employer" type="String" use="Required"/> 
   <xsd:element name="employer_business" type="employer_business" use="Required"/> 
   <xsd:element name="employer_address" type="employer_address" use="Required"/> 
   <xsd:element name="emplcountry_rescountry_details" type="string" use="Required if employer country is different from residence country"/> 
   </xsd:sequence>
   <xsd:element name="employer_address" use="Required"/> 
    <xsd:sequence>
    <xsd:attribute name="country" type="country" use="Required"/> 
    <xsd:attribute name="state" type="state" use="Required"/> 
    <xsd:attribute name="postal_code" type="String" use="Required"/> 
    <xsd:attribute name="city" type="String" use="Required"/> 
    <xsd:attribute name="street_1" type="String" use="Required"/> 
  </xsd:sequence>

Parameters

Name

Type

Description

is_duplicate_stmt_required

true

false

Indicates if IBKR should send duplicated statements to customers. For those included on FINRA Rule 3210 or equivalent on his/her jurisdiction, the expected answer is true, as they need to submit one copy to his/her employer compliance office.

employer

String; max characters 128

Name of the employer 

employer_business

Use /getEnumerations 'BUSINESS_OCCUPATION' to pull list of accepted values

 

occupation

Use /getEnumerations 'BUSINESS_OCCUPATION' to pull list of accepted values

 

country

3 Digit ISO Code

Country which the employer is located. 

state

3166-2 ISO Code

State/Province which the employer is located.

city

String; Max characters 100

City which the employer is located.

postal_code

String; Max characters 20

Postal / Zip code.

For countries that do not provide postal code, please enter “00000"

street_1

String; Max characters 200

Street which employer is located.

emplcountry_rescountry_details

String; Max characters 200

Explain why country of employment is different from country of current residence.

description

String; Max characters 200

Required IF business OR occupation= OTHER

*Other is not case/space sensitive.

Copy
employer_business is Non-Finance (IBLLC, IB-IE, IB-CE, and IB-UK)
<EmploymentDetails>
  <employer>Test Corporation</employer>
  <occupation>Engineering Manager</occupation>
  <employer_business>Aerospace Engineering</employer_business>
  <employer_address city="Stamford" country="USA" postal_code="94043" state="CT" street_1="25 Test St" />
</EmploymentDetails>
Copy
employer_business is Finance
<EmploymentDetails is_duplicate_stmt_required="true">
  <employer>Test Corporation</employer>
  <occupation>Engineering Manager</occupation>
  <employer_business>Finance/Broker Dealer</employer_business>
  <employer_address city="Stamford" country="USA" postal_code="94043" state="CT" street_1="25 Test St" />
</EmploymentDetails>
Copy
occupation is other
<EmploymentDetails>
  <employer>Test Corporation</employer>
  <occupation>Other</occupation>
  <description>Description of employment</description>
  <employer_business>Education</employer_business>
  <employer_address city="Stamford" country="USA" postal_code="94043" state="CT" street_1="25 Test St" />
</EmploymentDetails>
Copy
Country of employment is different from the country of residence.
<Residence street_1="1 Tester Street." city="Testing City" country="TWN" postal_code="11493" state="TW-TPE"/>
<EmploymentType>EMPLOYED</EmploymentType>
<EmploymentDetails>
 <employer_business>Car Sales</employer_business>
 <occupation>Salesman</occupation>
 <employer>BMW</employer>
 <employer_address street_1="1 Car Street" city="PERTH" state="AU-WA" country="AUS" postal_code="6100"/>
 <emplcountry_rescountry_details>I have relocated for work for 6 months for training.</emplcountry_rescountry_details>
</EmploymentDetails>