Request a bank account connection verification

To initiate a new bank account connection verification, you need to send a redirection URL, using the following endpoint:

POST /verifications/bank_account_connections

{
    "redirection_url": "https://redirectionurl.com",
    "workspace_id": "67536e37-c15e-4883-88bd-94a3057a6adb",
    "is_legal_person": false,
    "country_code": "GB",
    "locale": "en",
    "natural_person": {
        "first_name": "John",
        "last_name": "Doe"
    }
}

{
    "id": "75ad36cc-7e0f-464c-9241-569282c1cedc",
    "workspace_id": "67536e37-c15e-4883-88bd-94a3057a6adb",
    "created_at": "2025-07-24T13:01:55+00:00",
    "updated_at": "2025-07-24T13:01:55+00:00",
    "status": "pending",
    "status_codes": [],
    "data_anonymized": false,
    "verification_url": "https://api.yousign.app/verifications/bank_account_connection_verifications/75ad36cc-7e0f-464c-9241-569282c1cedc/start?s=80b03a2fb3c06c3e4b31b6c031b2e1aeac8a7df4ea41854ae4adf8a14606aecaf9e590fd0cca3411af035f7d3701e340fa46d2361c4c9518de9f2f1c8ec43a67&r=CY9cqLQRmtAN1A%3D%3D",
    "data": {
        "account_type": "personal",
        "account_identifiers": {
            "iban": null,
            "bic": null
        },
        "bank_name": null,
        "parties": [],
        "checks": null
    }
}

Query Param	Type	Description
redirection_url	url	[required] The URL to which the user is redirected once the verification is done. This must be configured before the first use.
workspace_id	string	[optional] Scope the verification within a workspace.
is_legal_person	boolean	[optional] The bank account holder is a business entity.
country_code	string	[optional] The market for which to fetch reports, for example, "GB".
locale	string	[optional] Locale to be used for end-user facing text, for example, "en".
[natural_person] first_name	string	[optional] First name of the bank account holder. Please consult this page to understand and optimise the matching of the first name. This field is not allowed when is_legal_person is `true` as name comparison cannot be performed with a legal person.
[natural_person] last_name	string	[optional] Last name of the bank account holder. Please consult this page to understand and optimise the matching of the last name. This field is not allowed when is_legal_person is `true` as name comparison cannot be performed with a legal person.

In the response, you'll find:

the id. This value is required to retrieve the verification results
the url to verify the bank account.

Countries covered (market)	Default locale
Austria 🇦🇹 (AT)	de
Belgium 🇧🇪 (BE)	fr
Czech Republic 🇨🇿 (CZ)	cs
Denmark 🇩🇰 (DK)	da
Estonia 🇪🇪 (ES)	et
Finland 🇫🇮 (FI)	fi
France 🇫🇷 (FR)	fr
Germany 🇩🇪 (DE)	de
Ireland 🇮🇪 (IE)	en
Italy 🇮🇹 (IT)	it
Latvia 🇱🇻(LV)	lv
Lithuania 🇱🇹(LT)	lt
Netherlands 🇳🇱 (NL)	nl
Norway 🇳🇴 (NO)	no
Poland 🇵🇱 (PL)	pl
Portugal 🇵🇹 (PT)	pt
Spain 🇪🇸 (ES)	es
Sweden 🇸🇪 (SE)	sv
United Kingdom 🇬🇧 (GB)	en