Request a bank account verification

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	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	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	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	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 `natural_person` is provided, do not include a `legal_person`.
iban	string	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	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	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.