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

# Initiate a new Bank Account Lookup Verification

`POST /verifications/bank_account_lookups`

Initiate a new Bank Account Lookup Verification to check if a bank account exists and belongs to the specified person or company.

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

**ℹ️ This endpoint accepts two request body formats — pick the one that matches your use case:**
- 📝 `application/json` — provide the natural person's bank account details directly, or reference an existing Workflow Session Applicant by ID.
- 📁 `multipart/form-data` — upload a binary file containing the natural person's bank account details.

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

## Request body

- union
  - InitiateBankAccountLookupWithNaturalPerson
    - `iban` string, required — The International Bank Account Number (IBAN) to verify. The IBAN must be a valid IBAN from a supported country: AT, BE, HR, CY, EE, FI, FR, DE, GR, IE, IT, LV, LT, LU, MT, NL, PT, SK, SI, ES.
    - `natural_person` InitiateBankAccountLookupWithNaturalPersonNaturalPerson, required — Information about the natural person who owns the bank account
      - `first_name` string, required — First name of the person
      - `last_name` string, required — Last name of the person
    - `workspace_id` string, uuid, nullable — Scopes the verification to a specific workspace. Defaults to the default workspace if not specified.
    - `workflow_session_id` string, uuid, nullable — 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 — 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.
  - InitiateBankAccountLookupFromApplicant
    - `applicant_id` string, uuid, required — The Applicant ID linked to the Workflow Session.

## Response `201`

Created

- BankAccountLookupFull
  - `id` string, uuid, required — The unique identifier for a resource.
  - `workspace_id` string, uuid, required — The Workspace ID in which the verification has been created.
  - `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.
  - `created_at` string, date-time, required — Creation date of the Bank Account Lookup Verification.
  - `updated_at` string, date-time, required — Update date of the Bank Account Lookup Verification.
  - `status` 'pending' | 'verified' | 'failed' | 'inconclusive', required — Status of the Bank Account Lookup 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 Bank Account Lookup Verification data has been anonymized. If set to `true`, all fields in the `data` field are set to NULL.
  - `applicant_id` string, uuid, nullable, required — Unique identifier of an Applicant.
  - `data` BankAccountLookupFullData, required
    - `extracted_from_document` BankAccountLookupFullDataExtractedFromDocument, nullable, required
      - `iban` string, nullable — The IBAN number extracted from the document.

## 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)