/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
beneficiary_external_reference query string Beneficiary external reference 
curl -X GET  --header "X-Auth-Token: XXXX-XXXXX-XXXX"  https://devapi.currencycloud.com/v2/beneficiaries/find

Response

{
    "beneficiaries": [
        {
            "id": "379bb676-5118-49c1-b7ec-b1d9c88bcbe6",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bc88c56e3b13",
            "email": null,
            "payment_types": [],
            "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-10-18T13:36:30+00:00",
            "updated_at": "2018-10-18T13:36:30+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "8bc61fad-bfcf-48e9-a361-860cc40d3af4",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bc88c56e3b13",
            "email": null,
            "payment_types": [],
            "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-10-18T13:36:31+00:00",
            "updated_at": "2018-10-18T13:36:31+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "471be8ec-32b5-44ac-bd20-fba47e618d4c",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bc88ccc5011c",
            "email": null,
            "payment_types": [],
            "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-10-18T13:38:47+00:00",
            "updated_at": "2018-10-18T13:38:47+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "bdb93c40-b426-4b90-b039-6d28906c0ccc",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bc88ccc5011c",
            "email": null,
            "payment_types": [],
            "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-10-18T13:38:49+00:00",
            "updated_at": "2018-10-18T13:38:49+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "bff4b545-52fe-4e16-b74c-cc0b43207723",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bc88f30126c4",
            "email": null,
            "payment_types": [],
            "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-10-18T13:49:02+00:00",
            "updated_at": "2018-10-18T13:49:02+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "2df6bca7-3fe3-4909-a187-1ffb2964badd",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bc88f30126c4",
            "email": null,
            "payment_types": [],
            "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-10-18T13:49:03+00:00",
            "updated_at": "2018-10-18T13:49:03+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "e453c1ed-f7dc-499a-abeb-be07b6e93630",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bc89087b8954",
            "email": null,
            "payment_types": [],
            "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-10-18T13:54:54+00:00",
            "updated_at": "2018-10-18T13:54:54+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "de532207-fc4d-4577-a121-305f5dbb0075",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bc89087b8954",
            "email": null,
            "payment_types": [],
            "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-10-18T13:54:55+00:00",
            "updated_at": "2018-10-18T13:54:55+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "9b1ea79a-d999-4bb9-9161-456604fbd0bc",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bc8a09087e19",
            "email": null,
            "payment_types": [],
            "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-10-18T15:03:13+00:00",
            "updated_at": "2018-10-18T15:03:13+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "d1f4c65f-4650-4534-b155-0cd98350bbd2",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bc8a09087e19",
            "email": null,
            "payment_types": [],
            "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-10-18T15:03:15+00:00",
            "updated_at": "2018-10-18T15:03:15+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "82ffb500-217f-4a7a-adcf-a91278115c69",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bc8a14956b65",
            "email": null,
            "payment_types": [],
            "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-10-18T15:05:53+00:00",
            "updated_at": "2018-10-18T15:05:53+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "967206b7-487a-49b0-9836-9362f5c9c6fd",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bc8a14956b65",
            "email": null,
            "payment_types": [],
            "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-10-18T15:05:53+00:00",
            "updated_at": "2018-10-18T15:05:53+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "b2d70fa7-44d8-46f5-bf4d-ea641486760f",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bc8a2188bbbb",
            "email": null,
            "payment_types": [],
            "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-10-18T15:09:46+00:00",
            "updated_at": "2018-10-18T15:09:46+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "2c1b3af2-a346-40df-a5ae-a2ff401b39c9",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bc8a2188bbbb",
            "email": null,
            "payment_types": [],
            "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-10-18T15:09:48+00:00",
            "updated_at": "2018-10-18T15:09:48+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "3fcbf299-8ba3-445d-adc0-6a663f074bef",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bc8a31d0e8ed",
            "email": null,
            "payment_types": [],
            "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-10-18T15:14:10+00:00",
            "updated_at": "2018-10-18T15:14:10+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "0af2ba95-52ef-47ec-848f-53213b53dcab",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bc8a31d0e8ed",
            "email": null,
            "payment_types": [],
            "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-10-18T15:14:11+00:00",
            "updated_at": "2018-10-18T15:14:11+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "6be74586-efc1-45e5-95c5-30eb77b65633",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bcda41c8e8aa",
            "email": null,
            "payment_types": [],
            "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-10-22T10:19:33+00:00",
            "updated_at": "2018-10-22T10:19:33+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "28279cc7-70fd-49ef-a669-875e76a8995c",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bcda41c8e8aa",
            "email": null,
            "payment_types": [],
            "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-10-22T10:19:35+00:00",
            "updated_at": "2018-10-22T10:19:35+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "7e6c34b6-d745-4aa5-add7-1c7248d9c117",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bcda4ec05585",
            "email": null,
            "payment_types": [],
            "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-10-22T10:23:04+00:00",
            "updated_at": "2018-10-22T10:23:04+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "786f7d10-72d9-45db-bcfb-769cbcf62907",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bcda4ec05585",
            "email": null,
            "payment_types": [],
            "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-10-22T10:23:05+00:00",
            "updated_at": "2018-10-22T10:23:05+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "2b21c7d8-a3bc-4c02-826b-1d5c14e66b30",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bcef21c39562",
            "email": null,
            "payment_types": [],
            "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-10-23T10:04:20+00:00",
            "updated_at": "2018-10-23T10:04:20+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "6c6faa24-9cc1-43ce-9476-93f2996f7de2",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bcef21c39562",
            "email": null,
            "payment_types": [],
            "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-10-23T10:04:20+00:00",
            "updated_at": "2018-10-23T10:04:20+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "f3787440-0109-4b4a-b5ed-7a62a3c4cb38",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bcef575dd89c",
            "email": null,
            "payment_types": [],
            "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-10-23T10:18:37+00:00",
            "updated_at": "2018-10-23T10:18:37+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "ff3a4572-deb0-447d-91a0-04dd22dc70ab",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bcef575dd89c",
            "email": null,
            "payment_types": [],
            "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-10-23T10:18:38+00:00",
            "updated_at": "2018-10-23T10:18:38+00:00",
            "beneficiary_external_reference": null
        },
        {
            "id": "4afc1e17-9c03-49f8-93ab-656df7b89947",
            "bank_account_holder_name": "My Test Account Holder",
            "name": "My Test Beneficiary 5bcef7f9db1f9",
            "email": null,
            "payment_types": [],
            "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-10-23T10:29:22+00:00",
            "updated_at": "2018-10-23T10:29:22+00:00",
            "beneficiary_external_reference": null
        }
    ],
    "pagination": {
        "total_entries": 590,
        "total_pages": 24,
        "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" }
beneficiary_date_of_birth_is_incorrect beneficiary_date_of_birth is incorrect
beneficiary_date_of_birth_is_earlier beneficiary_date_of_birth should be later than 1900-01-01 { "min_date" => "1900-01-01" }
beneficiary_date_of_birth_is_after beneficiary_date_of_birth should be earlier than todays date { "max_date" => "Todays 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 }
iban_is_in_invalid_format iban is in invalid format
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, bank_account_type, beneficiary_entity_type, beneficiary_city, beneficiary_address, beneficiary_company_name, beneficiary_first_name, beneficiary_last_name, beneficiary_state_or_province, beneficiary_postcode, created_at, updated_at { "range" => "bank_account_holder_name, beneficiary_country, currency, account_number, bic_swift, iban, default_beneficiary, bank_address, name, bank_account_type, beneficiary_entity_type, beneficiary_city, beneficiary_address, beneficiary_company_name, beneficiary_first_name, beneficiary_last_name, beneficiary_state_or_province, beneficiary_postcode, created_at, updated_at" }
on_behalf_of_self You cannot act on behalf of your own Contact
contact_not_found Contact was not found for this id
on_behalf_of_is_not_valid_uuid on_behalf_of should be in UUID format
beneficiary_external_reference_is_too_short beneficiary_external_reference can not be shorter than 1 character(s) { "minlength" => 1 }
beneficiary_external_reference_is_too_long beneficiary_external_reference can not be longer than 255 character(s) { "maxlength" => 255 }
cope_not_in_range scope should be in range: own, all, clients { "range" => "own, all, clients" }
beneficiary_entity_type_not_in_range beneficiary_entity_type should be in range: individual, company { "range" => "individual, company" }
beneficiary_company_name_is_too_short beneficiary_company_name can not be shorter than 1 character(s) { "minlength" => 1 }
beneficiary_company_name_is_too_long beneficiary_company_name can not be longer than 255 character(s) { "maxlength" => 255 }
beneficiary_first_name_is_too_short beneficiary_first_name can not be shorter than 1 character(s) { "minlength" => 1 }
beneficiary_first_name_is_too_long beneficiary_first_name can not be longer than 255 character(s) { "maxlength" => 255 }
beneficiary_last_name_is_too_short beneficiary_last_name can not be shorter than 1 character(s) { "minlength" => 1 }
beneficiary_last_name_is_too_long beneficiary_last_name can not be longer than 255 character(s) { "maxlength" => 255 }
beneficiary_city_is_too_short beneficiary_city can not be shorter than 1 character(s) { "minlength" => 1 }
beneficiary_city_is_too_long beneficiary_city can not be longer than 255 character(s) { "maxlength" => 255 }
beneficiary_postcode_is_too_short beneficiary_postcode can not be shorter than 1 character(s) { "minlength" => 1 }
beneficiary_postcode_is_too_long beneficiary_postcode can not be longer than 255 character(s) { "maxlength" => 255 }
beneficiary_state_or_province_is_too_short beneficiary_state_or_province can not be shorter than 1 character(s) { "minlength" => 1 }
beneficiary_state_or_province_is_too_long beneficiary_state_or_province can not be longer than 255 character(s) { "maxlength" => 255 }
page_type_is_wrong page should be of integer type { "type" => "integer" }
page_is_too_small page can not be smaller than 1 { "minvalue" => 1 }
per_page_type_is_wrong per_page should be of integer type { "type" => "integer" }
per_page_is_too_small per_page can not be smaller than 1 { "minvalue" => 1 }
order_asc_desc_not_in_range order_asc_desc should be in range: asc, desc { "range" => "asc, desc" }
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 post helpful?
Let us know if you liked the post. That’s the only way we can improve.
Yes
No

Start your borderless payments journey today

Talk to an expert

Cookies

This site uses cookies: Read our cookie policy