Filter inputs

Name

Type

Description

Mandatory

Available from version

BrickIds

Guid[]

Filter by an array of BrickIds. BrickId is the internal id of a Transfer Receiver



Persons

Guid[]

Filter by an array of Persons



TransferReceiverTypeKeys

String[]

Filter by an array of TransferReceiverTypeKeys

TransferReceiverTypeAutoGiro - This transfer receiver type is used for AutoGiro payments in Sweden.
TransferReceiverTypeBankGiro - This transfer receiver type is used for BankGiro payments in Sweden.
TransferReceiverTypeDirectBankDomestic - This transfer receiver type is used for making direct bank payment within the country of where you are located.
TransferReceiverTypeDirectBankForeign - This transfer receiver type is used for making direct bank payment outside the country of where you are located.
TransferReceiverTypePlusGiro - This transfer receiver type is used for PlusGiro payments in Sweden.
TransferReceiverTypeSecurities - This transfer receiver type is used for transferring financial securities
TransferReceiverTypeSecuritiesAccount - This transfer receiver type is used to represent an account with EuroClear or other clearing agency
TransferReceiverTypeSettlementCounterParty - This transfer receiver type is used to represent an account with a settlement counterparty. For example, if a legal entity has an account with a brokerage firm that can receive securities and the securities are to be sent to a clearing agency like EuroClear the brokerage firm will have an account with EuroClear and that account is the SettlementCounterparty.
TransferReceiverExtraInfoBicIban - This transfer receiver is used for withdrawals made using BIC and IBAN (also used for the new ISO 20022 format)
TransferReceiverTypeNorwegianBankAccount - This transfer receiver is used for transfers through a Norwegian bank account
TransferReceiverTypeNorwegianPostGiro - This transfer receiver is used for transfers through a Norwegian PostGiro
TransferReceiverTypeAvtaleGiro - This transfer receiver is used for transfers through a Norwegian AvtaleGiro


TransferReceiverExtraInfoBicIban from 2023-06-28

TransferReceiverTypeNorwegianBankAccount TransferReceiverTypeNorwegianPostGiro from 2024-03-06

TransferReceiverTypeAvtaleGiro from 2024-03-20

BatchOrders

bool

If orders for the TransferReceiver are allowed to be batched



BankNames

String[]

Filter by the name of the bank entered for the TransferReceiver


2.02.20160708

CounterpartyBrickIds

Guid[]

If the transfer receiver type is one that involves transferring securities instead of cash there will be a reference to a LegalEntity who is acting as counterparty. The full information about the counterparty can be fetched using GetPersons with this value as the input for BrickId.


2.02.20160722

CounterpartyNames

String[]

If the transfer receiver type is one that involves transferring securities instead of cash there will be a reference to a LegalEntity who is acting as counterparty and this is the company name of that Legal Entity.


2.02.20160722

States

String[]

Filter on the State of the TransferReceiver. Possible values are:

Admission_Active,

Admission_PendingCancelConfirmation,

Admission_Cancelled,

Admission_PendingCreateConfirmation,

Admission_Created,

Admission_ToBeCancelled,

Admission_Rejected



Response rows (Array) inherits from EntityBase

Name

Type

Description

Available from version

BrickId

Guid

The BrickId of the TransferReceiver


Person

Guid

The Person owning the TransferReceiver


TransferReceiverTypeKey

String

The TransferReceiverType key


Name

String

The name of the external account


Comment

String

The external account comment


AccountNo

String

The account number of the external account


CounterPartyClearingNo

String

The counterparty clearing number


CounterPartyAccountNo

String

The counterparty account number


PayerNumber

String

The PayerNumber of the external account


IBAN

String

The international bank account number


BIC

String

The business identifier code


Batchorders

bool

If orders for the TransferReceiver are allowed to be batched


BankName

String

The name of the bank entered for the TransferReceiver

2.02.20160708

CounterpartyBrickId

Guid

If the transfer receiver type is one that involves transferring securities instead of cash there will be a reference to a LegalEntity who is acting as counterparty. The full information about the counterparty can be fetched using GetPersons with this value as the input for BrickId.

2.02.20160722

CounterpartyName

String

If the transfer receiver type is one that involves transferring securities instead of cash there will be a reference to a LegalEntity who is acting as counterparty and this is the company name of that Legal Entity.

2.02.20160722

State

String

The state of the TransferReceiver (Admission_Cancelled, Admission_Created etc.)


BankGiroNumber

string

A TransferReceiver of the type TransferReceiverTypeBankGiro, will have the property BankGiroNumber.

2.37

Status

string

If the TransferReceiver has been Removed or Closed this property will be populated.

2.38

KID

string

A TransferReceiver of the type TransferReceiverTypeAvtaleGiro, will have the property KID.


Code examples

C# - GetTransferReceiver
//Use the GetTransferReceiver method 
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.GetTransferReceivers(new BFSServiceReference.GetTransferReceiversRequest()
{
    Credentials = credentials,

    identify = bfsidentifier, //Identifier is a unique token for your instance of BFS  

    Args = new BFSServiceReference.GetTransferReceiversArgs()
    {
        TransferReceiverTypeKeys = new []
        {
			"DomesticBank"
        }

    },

    Fields = new BFSServiceReference.GetTransferReceiverFields()
    {
        BrickId = true,
        AccountNo = true,
        BIC = true,
        BankName = true,
        IBAN = true
    },
});

foreach (var c in persons.Result)
{
    Console.WriteLine(c.BrickId + "," + c.AccountNo + "," + c.BIC + "," + c.BankName + "," + c.IBAN);
}