Request a bank account connection verification

On this page, you will learn how to initiate a new bank account verification using the API.

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": true,
    "market": "GB",
    "locale": "en"
}
{
    "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": "business",
        "account_identifiers": {
            "iban": null,
            "bic": null
        },
        "bank_name": null,
        "parties": []
    }
}
Query ParamTypeDescription
redirection_urlurl[required] The URL to which the user is redirected once the verification is done. This must be configured before the first use.
workspace_idstring[optional] Scope the verification within a workspace.
is_legal_personboolean[optional] The bank account holder is a business entity.
marketstring[optional] The market for which to fetch reports, for example, "GB".
localestring[optional] Locale to be used for end-user facing text, for example, "en".

In the response, you'll find:


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