Sign in

v1

latestOpenAPI 3.0.0proprietary2026-07-261695971.5 MB
Bank Account Lookup Verification

Initiate a new Bank Account Lookup Verification

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

ℹ️ 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
post/verifications/bank_account_lookups

Request body

OR

Example request

{
  "iban": "FR7630006000011234567890189",
  "natural_person": {
    "first_name": "John",
    "last_name": "Doe"
  },
  "workspace_id": "9412b83b-b4b9-4a94-97b5-2b43dfa4cde3",
  "workflow_session_id": "0ef334d2-7f36-4643-8a2a-4283b4a3e4a4",
  "previous_attempt_id": "9412b83b-b4b9-4a94-97b5-2b43dfa4cde4"
}

Response

Created

idstring uuid required

The unique identifier for a resource.

workspace_idstring uuid required

The Workspace ID in which the verification has been created.

workflow_session_idstring 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_idstring 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_atstring date-time required

Creation date of the Bank Account Lookup Verification.

updated_atstring 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_codesstring[] required

List of status codes. Indicates the cause when the status is failed or inconclusive.

data_anonymizedboolean 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_idstring uuid nullable required

Unique identifier of an Applicant.

Example response

{
  "id": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
  "workspace_id": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
  "workflow_session_id": "0ef334d2-7f36-4643-8a2a-4283b4a3e4a4",
  "previous_attempt_id": "9412b83b-b4b9-4a94-97b5-2b43dfa4cde4",
  "created_at": "2025-07-23T18:22:00Z",
  "updated_at": "2025-07-23T18:22:00Z",
  "status": "verified",
  "status_codes": [
    "BALV_1101"
  ],
  "applicant_id": "0ef334d2-7f36-4643-8a2a-4283b4a3e4a4",
  "data": {
    "extracted_from_document": {
      "iban": "FR7630006000011234567890189"
    }
  }
}