/v2/beneficiaries/find

GET

Find beneficiaries attached to the account or any sub-account owned by the authenticating user.

The API responses shown below are static. If you want to try out the API please login, or register for an API key

API parameters

Required
NameInTypeDescriptionEnumFormatDefault
X-Auth-Token header string Authentication token.
Optional
NameInTypeDescriptionEnumFormatDefault
on_behalf_of query string Contact UUID.
bank_account_holder_name query string Bank account holder's name.
beneficiary_country query string Two-letter country code. If the beneficiary is a company, the country in which the company is registered. If the beneficiary is an individual, a country in which the beneficiary holds nationality.
currency query string Currency in which money is held in the beneficiary's bank account. Three-digit currency code.
account_number query string Bank account number.
routing_code_type query string Local payment routing system. sort_code
bsb_code
institution_no
bank_code
branch_code
aba
clabe
cnaps
ifsc
routing_code_value query string Routing code.
bic_swift query string BIC/SWIFT code.
iban query string IBAN code.
default_beneficiary query boolean Payments are made automatically to default beneficiaries when a beneficiary is not specified.
bank_name query string Bank name.
bank_account_type query string Bank account type. checkings
savings
name query string Beneficiary name.
beneficiary_entity_type query string Legal entity. individual
company
beneficiary_company_name query string Required if "beneficiary_entity_type" is "company".
beneficiary_first_name query string Required if "beneficiary_entity_type" is "individual".
beneficiary_last_name query string Required if "beneficiary_entity_type" is "individual".
beneficiary_city query string City.
beneficiary_postcode query string Post code.
beneficiary_state_or_province query string State or province.
beneficiary_date_of_birth query string If "beneficiary_entity_type" is "company", date of registration. If "beneficiary_entity_type" is "individual", date of birth. ISO 8601 format YYYY-MM-DD. date
scope query string Search "own" account, "clients" sub-accounts, or "all" accounts. own
clients
all
 own
page query integer Page number.
per_page query integer Number of results per page.
order query string Any field name to change the sort order.
order_asc_desc query string Sort records in ascending or descending order. asc
desc
 asc 
curl -X GET  --header "X-Auth-Token: XXXX-XXXXX-XXXX"  https://devapi.currencycloud.com/v2/beneficiaries/find

Response

{
    "beneficiaries": [
        {
            "id": "3bc3a5fe-8257-4aee-ac6c-1abc15770f53",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 1",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-06-27T13:21:27+00:00",
            "updated_at": "2018-06-27T13:21:27+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "7125ce8b-6096-4475-b5c7-d7ca32091866",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 1",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-06-27T13:21:27+00:00",
            "updated_at": "2018-06-27T13:21:27+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "3cabf705-3f07-45e2-8118-21b53990dace",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 6",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-06-27T13:33:53+00:00",
            "updated_at": "2018-06-27T13:33:53+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "4c5ce15e-8706-4a8b-9dac-71158226293d",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 6",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-06-27T13:33:53+00:00",
            "updated_at": "2018-06-27T13:33:53+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "d50ec3c7-9dc6-4af3-b43a-eb590beb45db",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 9",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-06-27T14:02:01+00:00",
            "updated_at": "2018-06-27T14:02:01+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "acfd8834-a634-4e1e-a447-5a91dabf8aac",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 9",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-06-27T14:02:02+00:00",
            "updated_at": "2018-06-27T14:02:02+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "9f6a7177-0bf2-4d81-9e52-cf3f68f01ec9",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 9",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-06-27T14:36:42+00:00",
            "updated_at": "2018-06-27T14:36:42+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "adbaf7e1-eced-463c-8693-b8c016b86205",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 9",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-06-27T14:36:42+00:00",
            "updated_at": "2018-06-27T14:36:42+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "6fb28bc5-1977-4614-814e-261fb3947415",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-06-29T12:40:42+00:00",
            "updated_at": "2018-06-29T12:40:42+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "35b51bea-7d23-4722-bef8-9e434bc8b426",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-06-29T12:40:43+00:00",
            "updated_at": "2018-06-29T12:40:43+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "dce1fcc0-13f2-4467-a641-fee9f7911e9a",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 6",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-06-29T15:03:05+00:00",
            "updated_at": "2018-06-29T15:03:05+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "0a8ac390-76d3-482a-99ee-b5e7e6b8689d",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 6",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-06-29T15:03:06+00:00",
            "updated_at": "2018-06-29T15:03:06+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "55a96c92-ccc3-4149-b33a-705b624e40b3",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 6",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-07-06T10:30:37+00:00",
            "updated_at": "2018-07-06T10:30:37+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "465eb8d3-2dc5-4a97-a346-2c99c1936728",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 6",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-07-06T10:30:38+00:00",
            "updated_at": "2018-07-06T10:30:38+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "62028791-60a5-4d43-92a7-6adc5dfe8116",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 3",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-07-09T08:28:08+00:00",
            "updated_at": "2018-07-09T08:28:08+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "aabc0efa-ea65-4ba9-80d7-1f4e92588030",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 3",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-07-09T08:28:08+00:00",
            "updated_at": "2018-07-09T08:28:08+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "9b5b21cb-8332-45b6-b2ca-8b73dbde9e28",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 1",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-07-09T08:45:11+00:00",
            "updated_at": "2018-07-09T08:45:11+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "b07dd129-9952-4957-b0ad-54d8b1f165ad",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 1",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-07-09T08:45:12+00:00",
            "updated_at": "2018-07-09T08:45:12+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "04752f4e-bb37-4c20-a513-d1cb0003f36d",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 7",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-07-09T10:22:04+00:00",
            "updated_at": "2018-07-09T10:22:04+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "27cebe5b-c0c6-4fdb-8ad0-7e95a8242ff6",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 7",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-07-09T10:22:05+00:00",
            "updated_at": "2018-07-09T10:22:05+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "2bf48dba-a3cb-4ce0-8611-6a17797fff20",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 2",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-07-09T11:14:25+00:00",
            "updated_at": "2018-07-09T11:14:25+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "68702294-59d1-4122-95d8-d6c4c7bfb949",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 2",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-07-09T11:14:25+00:00",
            "updated_at": "2018-07-09T11:14:25+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "a7eeb14f-2095-4f17-9891-a02e25c82bc0",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 0",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": null,
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "GB",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "GBP",
            "account_number": "3284734675",
            "routing_code_type_1": "sort_code",
            "routing_code_value_1": "101193",
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": null,
            "iban": null,
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-07-10T16:49:56+00:00",
            "updated_at": "2018-07-10T16:49:56+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "58c8cfa3-a6a1-484e-98b6-73fb5c48748e",
            "bank_account_holder_name": "Acme GmbH",
            "name": "John Doe",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": "DE",
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "DE",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "EUR",
            "account_number": null,
            "routing_code_type_1": null,
            "routing_code_value_1": null,
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": "COBADEFF",
            "iban": "DE89370400440532013000",
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-07-11T09:47:34+00:00",
            "updated_at": "2018-07-11T09:47:34+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "2c543819-9b86-4874-8a75-cd25f9b2603a",
            "bank_account_holder_name": "Acme GmbH",
            "name": "John Doe",
            "email": null,
            "payment_types": [
                "regular"
            ],
            "beneficiary_address": [],
            "beneficiary_country": "DE",
            "beneficiary_entity_type": null,
            "beneficiary_company_name": null,
            "beneficiary_first_name": null,
            "beneficiary_last_name": null,
            "beneficiary_city": null,
            "beneficiary_postcode": null,
            "beneficiary_state_or_province": null,
            "beneficiary_date_of_birth": null,
            "beneficiary_identification_type": null,
            "beneficiary_identification_value": null,
            "bank_country": "DE",
            "bank_name": "TEST BANK NAME",
            "bank_account_type": null,
            "currency": "EUR",
            "account_number": null,
            "routing_code_type_1": null,
            "routing_code_value_1": null,
            "routing_code_type_2": null,
            "routing_code_value_2": null,
            "bic_swift": "COBADEFF",
            "iban": "DE89370400440532013000",
            "default_beneficiary": "false",
            "creator_contact_id": "a66ca63f-e668-47af-8bb9-74363240d781",
            "bank_address": [
                "TEST BANK ADDRESS",
                " NOT USING EXTERNAL SERVICE",
                " DEVELOPMENT ENVIRONMENT."
            ],
            "created_at": "2018-07-11T09:48:42+00:00",
            "updated_at": "2018-07-11T09:48:42+00:00",
            "beneficiary_external_reference": null
        }
    ],
    "pagination": {
        "total_entries": 147,
        "total_pages": 6,
        "current_page": 1,
        "per_page": 25,
        "previous_page": -1,
        "next_page": 2,
        "order": "created_at",
        "order_asc_desc": "asc"
    }
}
Error Codes
HTTP Status Code Description Params
400 bank_account_holder_name_is_too_short bank_account_holder_name can not be shorter than 1 character(s) { "minlength" => 1 }
bank_account_holder_name_is_too_long bank_account_holder_name can not be longer than 255 character(s) { "maxlength" => 255 }
beneficiary_country_is_in_invalid_format beneficiary_country is in invalid format
currency_is_in_invalid_format currency is in invalid format
bank_name_is_too_short bank_name can not be shorter than 1 character(s) { "minlength" => 1 }
bank_name_is_too_long bank_name can not be longer than 100 character(s) { "maxlength" => 100 }
bank_account_type_not_in_range bank_account_type should be in range: checking, savings { "range" => "checking, savings" }
account_number_is_too_short account_number can not be shorter than 1 character(s) { "minlength" => 1 }
account_number_is_too_long account_number can not be longer than 50 character(s) { "maxlength" => 50 }
incorrect_mapping Following parameters must have same keys { "parameters" => "routing_code_value,routing_code_type" }
routing_code_type_is_too_short routing_code_type can not be shorter than 1 character(s) { "minlength" => 1, "indices" => ["0", "1"] }
routing_code_type_is_too_long routing_code_type can not be longer than 50 character(s) { "maxlength" => 50, "indices" => ["0", "1"] }
routing_code_type_type_is_wrong routing_code_type should be of hash type { "type" => "hash" }
routing_code_type_not_included_in_list One or more of routing_code_type items are not included in list { "list" => "sort_code,bsb_code,institution_no,bank_code,branch_code,aba,clabe }
routing_code_type_too_many_items routing_code_type should have less than 50 items { "maxcount" => 50 }
beneficiary_date_of_birth_type_is_wrong beneficiary_date_of_birth should be of date type { "type" => "date" }
routing_code_value_is_too_short routing_code_value can not be shorter than 1 character(s) { "minlength" => 1, "indices" => ["0", "1"] }
routing_code_value_is_too_long routing_code_value can not be longer than 50 character(s) { "maxlength" => 50, "indices" => ["0", "1"] }
routing_code_value_type_is_wrong routing_code_value should be of hash type { "type" => "hash" }
bic_swift_is_in_invalid_format bic_swift is in invalid format
iban_is_too_long iban can not be longer than 34 character(s) { "maxlength" => 34 }
iban_is_too_short iban can not be shorter than 1 character(s) { "minlength" => 1 }
default_beneficiary_type_is_wrong default_beneficiary should be of boolean type { "type" => "boolean" }
name_is_too_short name can not be shorter than 1 character(s) { "minlength" => 1 }
name_is_too_long name can not be longer than 100 character(s) { "maxlength" => 100 }
order_asc_desc_not_in_range order_asc_desc should be in range: asc, desc { "range" => "asc, desc" }
order_not_in_range order should be in range: bank_account_holder_name, beneficiary_country, currency, account_number, bic_swift, iban, default_beneficiary, bank_address, name, created_at { "range" => "order should be in range: bank_account_holder_name, beneficiary_country, currency, account_number, bic_swift, iban, default_beneficiary, bank_address, name, created_at" }
on_behalf_of_self You cannot act on behalf of your own Contact
contact_not_found Contact was not found for this id
401 invalid_supplied_credentials Authentication failed with the supplied credentials
429 too_many_requests Too many requests have been made to the api. Please refer to the Developer Center for more information
500 internal_server_error Internal server error
503 service_unavailable Service is temporary unavailable
Was this page helpful?
Yes
No

Start your borderless payments journey today

Talk to an expert

Cookies

This site uses cookies: Read our cookie policy