---
title: "Initiate a new Bank Account Verification"
method: POST
path: "/verifications/bank_accounts"
tags: ["Bank Account Verification"]
---

# Initiate a new Bank Account Verification

`POST /verifications/bank_accounts`

Ask for a Bank Account Verification by sending the file containing the bank account details, such as IBAN and BIC.

A Bank Account Verification can be requested as follows:
- **Bank Account verification**: This option only checks the validity of the Bank Account document.
- **Bank Account verification with legal person**: This option checks both:
  - the validity of the Bank Account document
  - the coherence between the provided **legal person** names and those on the document.
- **Bank Account verification with natural person**: This option checks both:
  - the validity of the Bank Account document
  - the coherence between the provided **natural person** names and those on the document.

Related guide: [Bank Account Document Verification](https://developers.youtrust.com/docs/bank-account-details-verification)

**ℹ️ This endpoint accepts two request body formats — pick the one that matches your use case:**
- 📁 `multipart/form-data` — upload a binary file containing the bank account details (IBAN/BIC).
- 📝 `application/json` — reference an existing Workflow Session Applicant by ID.

**🔓 Endpoint access**
- Environments: `production`, `sandbox`
- API key scopes: `organization`, `workspace`
- Plans: `pro`, `scale`
- Add-ons (for production access): `Verify - Bank account document check`

## Request body

- InitiateBankAccountFromApplicant
  - `applicant_id` string, uuid, required — The Applicant ID linked to the Workflow Session.

## Response `201`

Created

- BankAccountFull
  - `id` string, uuid, required — The unique identifier for a resource.
  - `workspace_id` string, uuid — The Workspace ID in which the verification has been created.
  - `created_at` string, date-time, required — Creation date of the Bank Account Verification.
  - `updated_at` string, date-time, required — Update date of the Bank Account Verification.
  - `status` 'pending' | 'awaiting_data' | 'verified' | 'failed' | 'inconclusive', required — Status of the Bank Account Verification.
  - `status_codes` string[], required — List of status codes. Indicates the cause when the status is `failed` or `inconclusive`.
  - `data_anonymized` boolean, required — Indicates if the personal data extracted from the document has been anonymized. If set to `true`, the personal data has been anonymized and most fields will be NULL.
  - `workflow_session_id` string, uuid, nullable, required — Unique identifier of a Workflow Session. When provided, an Action is created in the Workflow Session, and this resource is associated with that Action.
  - `previous_attempt_id` string, uuid, nullable, required — ID of the previous attempt within the same `workflow_session_id`. Allows continuity between multiple attempts of the same Action. Null if this is the first attempt.
  - `applicant_id` string, uuid, nullable, required — Unique identifier of an Applicant.
  - `data` BankAccountFullAllOfData, required
    - `extracted_from_document` BankAccountFullAllOfDataExtractedFromDocument, required — Data extracted from the provided bank account document
      - `iban` string, nullable, required — International Bank Account Number (IBAN)
      - `bic` string, nullable, required — Business Identifier Codes (BIC)

## Other responses

- `400` — Bad request
- `401` — Access unauthorized
- `403` — Access forbidden
- `405` — This method is not allowed
- `415` — UnsupportedMediaType
- `429` — Too Many Requests, please try again later.
- `500` — Internal Server Error

---

[API](https://skmtc.net/yousign/apis/public-api-v3.md) · [All operations](https://skmtc.net/yousign/apis/public-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yousign/public-api-v3/revisions/8d258c0b45d6/schema)