Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Filter inputsFilter inputs

NameTypeDescriptionMandatoryAvailable from version
BrickIdGuid[]Filter by array of BrickIds. BrickId is the internal id of a legal entity

CustomerNosString[]Filter by array of Customer Numbers

UserNameStringFilter by single Username

UserNamesString[]Filter by array of Usernames
2.02.20160506
PersonalNumbersString[]Filter by array of tax identification numbers

ResellerNoStringFilter by single Reseller Number

ResellerNosString[]Filter by multiple Reseller Numbers

IsFundEntityBoolFilter by Legal Entities that are set as investment funds


IsIssuerBoolFilter by Legal Entities that are set as Issuer

ExternalReferencesString[]Filter by array of External References

CreatedDateFromDateTimeWhen used, both from date and to date should be provided in the request
2.02.20160506
CreatedDateToDateTime
2.02.20160506
LastLoginDateFromDateTimeWhen used, both from date and to date should be provided in the request
2.02.20160506
LastLoginDateToDateTime
2.02.20160506
CitiesString[]Filter by cities for the LegalEntity
2.02.20160506
CountriesString[]Filter by countries for the LegalEntity
2.02.20160506
EmailsString[]Filter by e-mails for the LegalEntity
2.02.20160506
PostalCodesString[]Filter by postalcodes for the LegalEntity
2.02.20160506
TaxCountriesString[]Filter by tax countries for the LegalEntity
2.02.20160506
StreetAddressesString[]Filter by street addresses for the LegalEntity
2.02.20160506
UserDomainsString[]

Filter by the type of user, available values are:

  • bricknode (Front)
  • bricknodepartner (Partner)
  • bricknodeadmin (Admin)
  • inactive



2.02.20160701
LEIstring[]The Legal Entity Identifier that should be used for companies when performing TRS2 reporting
2.11
TRSIdstring[]The TRS identification code that should be used for natural persons when performing TRS2 reporting
2.11
TRSCountriesstring[]According to ISO-standard here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2, though only certain countries are available. See GetTRSCountries.
2.11
TRSIdTypestring[]The id type for TRS reporting regarding natural persons. Can be either NID, PASSPORT or CONCAT.
2.11
TRSManualHandlingboolTells whether the person should have Manual handling in the TRS reporting or not.
2.11
IsProfessionalboolTells whether the person is a professonal investor in the TRS reporting or not.
2.11
MifidOkboolTells whether the person is compliant for MIFID II or not.
2.11
IsPEPboolTells whether the person is a politically exposed person or not.
2.11
BranchCountriesstring[]According to ISO-standard here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
2.11
DefaultCompanyGuid[]The company where the person is employed.
2.11

Response rows (Array) inherits from EntityBase

Mandatory[]

Filter by the type of user, available values are:

  • bricknode (Front)
  • bricknodepartner (Partner)
  • bricknodeadmin (Admin)
  • inactive
NameTypeDescriptionAvailable from version
BrickIdGuidFilter by array of BrickIds. BrickId is the internal id of a legal entityCustomerNosString[]Filter by array of Customer NumbersUserNameStringFilter by single UsernameUserNamesString[]Filter by array of UsernamesThe BrickId of the Legal Entity
CreatedDateDateTimeThe date when the person was created2.02.20160506PersonalNumbers
FirstNameString[]Filter by array of tax identification numbersResellerNoStringFilter by single Reseller NumberResellerNosString[]Filter by multiple Reseller NumbersIsFundEntityBoolFilter by Legal Entities that are set as investment fundsIsIssuerBoolFilter by Legal Entities that are set as IssuerExternalReferencesString[]Filter by array of External ReferencesCreatedDateFromDateTimeWhen used, both from date and to date should be provided in the request2.02.20160506CreatedDateToDateTime2.02.20160506LastLoginDateFromDateTimeWhen used, both from date and to date should be provided in the request2.02.20160506LastLoginDateToDateTime2.02.20160506CitiesString[]Filter by cities for the LegalEntity2.02.20160506CountriesString[]Filter by countries for the LegalEntity2.02.20160506EmailsString[]Filter by e-mails for the LegalEntity2.02.20160506PostalCodesString[]Filter by postalcodes for the LegalEntity2.02.20160506TaxCountriesString[]Filter by tax countries for the LegalEntity2.02.20160506StreetAddressesString[]Filter by street addresses for the LegalEntity2.02.20160506UserDomainsString[]2.02.20160701

Response rows (Array) inherits from EntityBase

TaxCountry

The type of user, available values are:

  • bricknode (Front)
  • bricknodepartner (Partner)
  • bricknodeadmin (Admin)
  • inactive
NameTypeDescriptionAvailable from version
BrickIdGuidThe BrickId of the Legal Entity
CreatedDateDateTimeThe date when the person was created2.02.20160506
FirstNamestringThe first name of the Legal EntityLastNamestringThe last name of the Legal EntityMiddleNamesstringThe middle name of the Legal EntityUserNamestringThe username of the Legal EntityEmailstringThe email of the Legal EntityPersonalNumberstringThe tax identification number of the Legal Entity
BirthDateDateTimeThe date of person's birth.2.04
ResellerNostringThe reseller number of the Legal EntityResellerIdGuidThe reseller id of the Legal EntityIsApprovedboolIf true the Legal Entity is approved (activated) in the BFS instance and can loginAddressCitystringThe name of the city where the Legal Entity residesAddressStreetstringThe name of the street where the Legal Entity residesAddressZipstringThe postal code where the Legal Entity residesCommentstringA free text comment that can be used for a Legal EntityExternalReferencestringAn external reference that can be used for a Legal Entity to for example link the Legal Entity to an external system with the id of the Legal Entity in the external systemPassportNumberstringThe passport number of the Legal EntityPhoneHomestringThe phone number of the Legal EntityPhoneWorkstringThe work phone number of the Legal EntityIsTaxPayerboolIf true the Legal Entity will be subject to tax reporting and tax withholdingIsInsuranceCompanyboolIf the Legal Entity is categorized as an insurance companyIsInsuranceProductSupplierboolIf the Legal Entity is categorized as a product supplier for insurance productsIsApprovedForStructsboolIf the Legal Entity is approved for investing in structured productsIsVerifiedboolIf the Legal Entity is verified according to Know Your Customer regulationsIsFundEntityboolIf the Legal Entity is categorized as an investment fund. An investment fund can have a relationship to a fund company that manages the fund.IsFundCompanyboolIf the Legal Entity is categorized as a fund company. A fund company can have a relationship to fund entities which it manages.IsIssuerboolIf the Legal Entity is categorized as issuer.SectorNACEstringOnly used for Legal Entities that has IsIssuer set to true.GroupCode

string

Only used for Legal Entities that has IsIssuer set to true.ExternalRatingstringOnly used for Legal Entities that has IsIssuer set to true.RatingAgencystringOnly used for Legal Entities that has IsIssuer set to true.InstrumentTypesStringstring

Only used for Legal Entities that has IsIssuer set to true. This is the instrument types the issuer can issue. Value should be a comma separated string with numbers.

For example: "1,2". For information about which number to use: InstrumentTypes.

GenderstringValue should be Male, Female, CompanyTitlestringValue should be Miss, Mr, Ms, Dr, MrsCountrystringAccording to ISO-standard here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2stringThe first name of the Legal Entity
LastNamestringThe last name of the Legal Entity
MiddleNamesstringThe middle name of the Legal Entity
UserNamestringThe username of the Legal Entity
EmailstringThe email of the Legal Entity
PersonalNumberstringThe tax identification number of the Legal Entity
BirthDateDateTimeThe date of person's birth.2.04
ResellerNostringThe reseller number of the Legal Entity
ResellerIdGuidThe reseller id of the Legal Entity
IsApprovedboolIf true the Legal Entity is approved (activated) in the BFS instance and can login
AddressCitystringThe name of the city where the Legal Entity resides
AddressStreetstringThe name of the street where the Legal Entity resides
AddressZipstringThe postal code where the Legal Entity resides
CommentstringA free text comment that can be used for a Legal Entity
ExternalReferencestringAn external reference that can be used for a Legal Entity to for example link the Legal Entity to an external system with the id of the Legal Entity in the external system
PassportNumberstringThe passport number of the Legal Entity
PhoneHomestringThe phone number of the Legal Entity
PhoneWorkstringThe work phone number of the Legal Entity
IsTaxPayerboolIf true the Legal Entity will be subject to tax reporting and tax withholding
IsInsuranceCompanyboolIf the Legal Entity is categorized as an insurance company
IsInsuranceProductSupplierboolIf the Legal Entity is categorized as a product supplier for insurance products
IsApprovedForStructsboolIf the Legal Entity is approved for investing in structured products
IsVerifiedboolIf the Legal Entity is verified according to Know Your Customer regulations
IsFundEntityboolIf the Legal Entity is categorized as an investment fund. An investment fund can have a relationship to a fund company that manages the fund.
IsFundCompanyboolIf the Legal Entity is categorized as a fund company. A fund company can have a relationship to fund entities which it manages.
IsIssuerboolIf the Legal Entity is categorized as issuer.
SectorNACEstringOnly used for Legal Entities that has IsIssuer set to true.
GroupCode

string

Only used for Legal Entities that has IsIssuer set to true.
ExternalRatingstringOnly used for Legal Entities that has IsIssuer set to true.
RatingAgencystringOnly used for Legal Entities that has IsIssuer set to true.
InstrumentTypesStringstring

Only used for Legal Entities that has IsIssuer set to true. This is the instrument types the issuer can issue. Value should be a comma separated string with numbers.

For example: "1,2". For information about which number to use: InstrumentTypes.


GenderstringValue should be Male, Female, Company
TitlestringValue should be Miss, Mr, Ms, Dr, Mrs
CountrystringAccording to ISO-standard here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
TaxCountrystringAccording to ISO-standard here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
CustomerNostringThe customer number of the Legal Entity
BICstringA Legal Entity can have a BIC code associated to it which is returned in this field.
LastLoginDateDateTimeThe timestamp of the last login for the user
UserDomainstring

The type of user, available values are:

  • bricknode (Front)
  • bricknodepartner (Partner)
  • bricknodeadmin (Admin)
  • inactive


2.02.20160701
PostageAddressStreetstringThe postage address street of the Legal Entity2.09
PostageAddressCOstringThe postage address of the Legal Entity2.09
PostageAddressZipstringThe postage zip of the Legal Entity2.09
PostageAddressCitystringThe postage city of the Legal Entity2.09
PostageAddressCountrystringAccording to ISO-standard here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-22.09
PostageAddressDepartmentstringThe postage department of the Legal Entity2.09
CustomFieldsobject[]CustomFields is an array of CustomField objects. Each CustomField consists of two strings, FieldName and Value. There are no datatypes associated with these properties, they are just a way for api-users to add custimized data to the object.2.09
LEIstringThe Legal Entity Identifier that should be used for companies when performing TRS2 reporting2.11
TRSIdstringThe TRS identification code that should be used for natural persons when performing TRS2 reporting2.11
TRSCountrystringAccording to ISO-standard here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2CustomerNostringThe customer number of the Legal EntityBICstringA Legal Entity can have a BIC code associated to it which is returned in this field.LastLoginDateDateTimeThe timestamp of the last login for the userUserDomainstring2.02.20160701
PostageAddressStreetstringThe postage address street of the Legal Entity2.09
PostageAddressCOstringThe postage address of the Legal Entity2.09
PostageAddressZipstringThe postage zip of the Legal Entity2.09
PostageAddressCitystringThe postage city of the Legal Entity2.09
PostageAddressCountry, though only certain countries are available. See GetTRSCountries.2.11
TRSIdTypestringThe id type for TRS reporting regarding natural persons. Can be either NID, PASSPORT or CONCAT.2.11
TRSManualHandlingboolTells whether the person should have Manual handling in the TRS reporting or not.2.11
IsProfessionalboolTells whether the person is a professonal investor in the TRS reporting or not.2.11
MifidOkboolTells whether the person is compliant for MIFID II or not.2.11
IsPEPboolTells whether the person is a politically exposed person or not.2.11
BranchCountrystringAccording to ISO-standard here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-22.09
PostageAddressDepartmentstringThe postage department of the Legal Entity2.09
CustomFieldsobject[]CustomFields is an array of CustomField objects. Each CustomField consists of two strings, FieldName and Value. There are no datatypes associated with these properties, they are just a way for api-users to add custimized data to the object11
DefaultCompanyGuidThe company where the person is employed.2.0911

Code examples

Code Block
languagec#
themeRDark
titleC# - Get all legal entities from a BFS instance
linenumberstrue
collapsetrue
//Use the GetPersons method to get all LegalEntities in the BFS instance and write
//the BrickId's and names in the console
var client = new BFSServiceReference.bfsapiSoapClient();
var credentials = new BFSServiceReference.Credentials()
{
    UserName = bfsusername, //Username of administrative user in your instance of BFS
    Password = bfspassword, //Password of the administrative user in your instance of BFS
};
var persons = client.GetPersons(new BFSServiceReference.GetPersonRequest()
{
    Credentials = credentials,
    identify = bfsidentifier, //Identifier is a unique token for your instance of BFS
   
    Fields = new BFSServiceReference.GetPersonFields()
    {
        BrickId = true,
        UserName = true,
        FirstName = true,
        LastName = true,
    },
});
foreach (var c in persons.Result)
{
    Console.WriteLine(c.BrickId + "," + c.FirstName + "," + c.LastName);
}

...