AddMiFIRData

https://[domain]/ws/eca/update

  • Add OR Update MiFIR data for existing account.

    MiFIR Transaction Reporting applies to European Economic Area (“EEA") Investment Firms. As a client of an investment firm that uses the platform, you may be required to provide additional information to allow the proper transaction reports to be filed.

    More Information

  • Fully Disclosed Client (Individual, Retirement, Joint)

  • Advisor Client (Individual, Retirement, Joint)

  • Requests submitted prior to 5pm EST will be processed same day.

  • Requests submitted after 5pm EST will be processed the following business day.

XSD

Copy 
<xsd:complexType name="AddMiFIRData">
  <xsd:sequence>
   <xsd:element name="Identification" type="IndividualIdentification" minOccurs="0" maxOccurs="5" />
  </xsd:sequence>
 <xsd:sequence>
  <xsd:attribute name="reference_account_id" type="xsd:string" use="required">
  <xsd:attribute name="title" type="xsd:string" use="required">
<xsd:sequence>
</xsd:complexType>

Attributes

Name

Type

Description

reference_account_id

String

IBKR account ID of the advisor/broker client account MiFIR data is being added for.

Title

ACCOUNT HOLDER

FIRST HOLDER

SECOND HOLDER

Individual Account Type: Title will always be “ACCOUNT HOLDER"

 

Joint Account Type: Title will be one of:

FIRST HOLDER

SECOND HOLDER

Identification

Identification

Identification node included in XML request should match Identification node that was included in Account Opening Request 

Sample

Copy 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AcctMgmtRequests xmlns="http://www.interactivebrokers.com/schemas/IBCust_import">
  <AddMiFIRData reference_account_id="U000008" title="ACCOUNT_HOLDER">
    <Identification citizenship="CZE" Passport="1122334" NationalCard="112233/150" IssuingCountry="CZE" LegalResidenceCountry="CZE"/> 
   </AddMiFIRData>
</AcctMgmtRequests>

Name

Type

Description

Execution_Date

YYYY/MM/DD HH:MM:SS

Date/Time which the file was processed by IBKR.

Process_File

FirmName_YYYY-MM-DD_######.xml

File name of the request file.

Client

FirmName

Name of the Counterparty

Client_Master_Acct

String

Master account number
AddMiFIRData String Status of the request
reference_account_id String IBKR account ID of the advisor/broker client account which the request is being submitted for
request_status

PROCESSED

ERROR

PENDING

 Status of the request
message String Status of the request.
request_id Non-negative integer Unique ID which IBKR assigns to the request. The ID can be used to query status request at a later time using //getAmRequestStatus endpoint
message String Includes details on the status of the request IF status=”PENDING" or "PROCESSED "
Pending_Tasks <Tasks> Includes pending tasks associated with the info change request IF status=”PENDING"
Errors String Includes error message if status=”ERROR”

Sample

Copy
Success
<?xml version='1.0' encoding='UTF-8'?>
<Process>
  <Execution ECA_XML_Schema_Version="15-Nov-2018">
    <Execution_Date>2020/02/20 00:44:38</Execution_Date>
    <Process_File>TesterFA_2020-02-20_124438885_761126.xml</Process_File>
    <Client>TesterFA</Client>
    <Client_Master_Acct>F1234567</Client_Master_Acct>
  </Execution>
   <AddMiFIRData reference_account_id="U2088007" request_status="PROCESSED" message="Status of the request" request_id="50813"/>
</Process>
Copy
Error
<?xml version='1.0' encoding='UTF-8'?>
<Process>
  <Execution ECA_XML_Schema_Version="15-Nov-2018">
    <Execution_Date>2020/02/20 00:44:38</Execution_Date>
    <Process_File>TesterFA_2020-02-20_124438885_761126.xml</Process_File>
    <Client>TesterFA</Client>
    <Client_Master_Acct>F1234567</Client_Master_Acct>
  </Execution>
   <AddMiFIRData reference_account_id="U2088007" request_status="ERROR" request_id="50813">
    <Error>Error Message Here</Error>
  </AddMiFIRData>
</Process>