Request a bank account verification

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

To initiate a new bank account verification, send the file containing the bank account details using the following endpoint:

POST /verifications/bank_accounts

curl --location --request POST '{baseUrl}/verifications/bank_accounts' \
--header 'Authorization: Bearer {apiKey}' \
--form 'file=@"/path/to/the/document/bank_details.jpeg"'

{
    "id": "21417328-7a20-4715-800d-350cad8d2bd1",
    "workspace_id": "090b4f7e-25e8-423d-9387-741f6188ba7a",
    "created_at": "2025-03-24T13:32:26+00:00",
    "updated_at": "2025-03-24T13:32:26+00:00",
    "status": "pending",
    "status_codes": [],
    "data_anonymized": false,
    "data": {
        "extracted_from_document": {
            "iban": null,
            "bic": null
        }
    }
}

Query Param	Type	Description
file	file	[required]The file containing the bank account details. Accepted formats: PNG, JPEG, JPG, PDF. Max size: 10 MB. Max resolution: 20 mpx.
natural_person[first_name]	string	[optional] The first name of the bank account holder. The first name provided must match exactly as it appears on the file containing the bank account details, as a consistency check will be performed. Do not include any honorary titles. If a `natural_person` is provided, do not include a `legal_person`.
natural_person[last_name]	string	[optional] The last name of the bank account holder. The last name provided must match exactly as it appears on the file containing the bank account details, as a consistency check will be performed. Do not include any honorary titles. If a `natural_person` is provided, do not include a `legal_person`.
legal_person[name]	string	[optional] The legal name of the company when the bank account holder is a business entity. The company name provided must match exactly as it appears on the file containing the bank account details, as a consistency check will be performed. If a `legal_person` is provided, do not include a `natural_person`.
iban	string	[optional] You may provide an IBAN for comparison with the one extracted from the file containing the bank account details. Ensure the IBAN provided contains no spaces.
bic	string	[optional] You may provide a BIC for comparison with the one extracted from the file containing the bank account details. Ensure the BIC provided contains no spaces.
workspace_id	string	[optional] Scopes the verification to a specific workspace. Defaults to the main workspace if not specified.

In the response, you'll find the id. This value is required to retrieve the verification results.

Updated 4 days ago