---
title: "Account Verification API"
method: POST
path: "/verifications/v1/accounts"
tags: ["International AVS"]
---

# Account Verification API

`POST /verifications/v1/accounts`

Verifies account ownership and details for UAE and  international accounts. **A step by step guide** [here](https://docs.leantech.me/docs/how-to-use-account-verification-service).

## Request body

- InternationalAvsRequest
  - `country_code` string, required — The country code of the account holder in ISO 3166-1 alpha-2 format. Supported country codes for international AVS. - AE (United Arab Emirates) - AR (Argentina) - AT (Austria) - AU (Australia) - BD (Bangladesh) - BE (Belgium) - BG (Bulgaria) - BR (Brazil) - CL (Chile) - CN (China) - CO (Colombia) - CY (Cyprus) - DE (Germany) - EC (Ecuador) - EE (Estonia) - ES (Spain) - FI (Finland) - FR (France) - GB (United Kingdom) - GR (Greece) - HR (Croatia) - ID (Indonesia) - IE (Ireland) - IN (India) - IT (Italy) - KR (South Korea) - LT (Lithuania) - LU (Luxembourg) - LV (Latvia) - MT (Malta) - MX (Mexico) - MY (Malaysia) - NG (Nigeria) - NL (Netherlands) - NP (Nepal) - PE (Peru) - PK (Pakistan) - PL (Poland) - PT (Portugal) - SA (Saudi Arabia) - SI (Slovenia) - SK (Slovakia) - TR (Turkey) - UG (Uganda) - US (United States) - UY (Uruguay) - VN (Vietnam) - ZA (South Africa)
  - `type` 'PERSONAL' | 'BUSINESS', required — Type of account
  - `account_details` InternationalAvsAccountDetails, required
    - `type` 'IBAN' | 'ACCOUNT_ID', required — Type of account identification. IBAN:International Bank Account Number - used for Pakistan and some European countries ACCOUNT_ID: Local account identifier - used for most countries
    - `value` string, required — Account identification value
    - `account_type` 'SAVINGS' | 'CHECKING' — Type of bank account. Required for specific countries (e.g., Colombia). SAVINGS: Savings account CHECKING: Checking/Current account
  - `identifications` InternationalAvsIdentificationDto[], required — Required identifications based on country and account type
    - `type` 'FULL_NAME' | 'REGISTRATION_ID' | 'GIVEN_NAME' | 'SURNAME' | 'NATIONAL_ID' | 'EMIRATES_ID' | 'TRADE_LICENCE' | 'UNIFIED_NUMBER' | 'COMMERCIAL_REGISTRATION' | 'CC' | 'NIT', required — Identification type. FULL_NAME: Full name of the account holder REGISTRATION_ID: Business registration identifier GIVEN_NAME: First name of the account holder SURNAME: Last name of the account holder NATIONAL_ID: National identification number EMIRATES_ID: UAE Emirates ID TRADE_LICENCE: Trade license number UNIFIED_NUMBER: Unified number identifier COMMERCIAL_REGISTRATION: Commercial registration number CC: Colombia personal ID NIT: Colombia business tax ID
    - `value` string, required — Identification value
  - `bank_identifier` InternationalAvsRequestBankIdentifier
    - `type` 'BIC' | 'CLEARING_ID', required — Types of bank identifiers. BIC: Bank Identifier Code (SWIFT code) - used for most countries CLEARING_ID: Bank clearing system identifier
    - `value` string, required — Bank identifier value

## Response `200`

Account verification completed successfully

- InternationalAvsResponse
  - `status` 'OK' | 'PENDING' | 'FAILED' | 'CONSENT_EXPIRED' | 'RECONNECT_REQUIRED' | 'PROCESSING_STARTED', required — The status of the request
  - `results_id` string, uuid, required — The unique identifier for the request
  - `message` string, required — A message describing the status of the request
  - `meta` object, nullable — Meta information about the request
  - `timestamp` string, date-time, required — The datetime of when the request was made
  - `status_detail` StatusDetail, nullable
    - `granular_status_code` string, nullable — Granular status code
    - `status_additional_info` string, nullable — Additional information about the status
  - `verifications` InternationalAvsVerificationPayload, nullable
    - `account_ownership_verified` boolean, required — Whether the account ownership is verified
    - `matching` MatchingResult, nullable — Where `iban_ownership_verified` is false the matching attribute will identify whether there is a 'partial' or 'no match'
      - `type` 'PARTIAL' | 'NO_MATCH' — Identifies whether there is a partial match or no match
      - `score` number, double — Similarity score on a scale of 0 to 1, with 0 being no similarity and 1 being high similarity.
    - `bank_details` InternationalAvsResponseBankDetails, nullable
      - `bank_name` Translation
        - `en` string, required — English translation
        - `ar` string, nullable — Arabic translation
      - `bank_identifiers` InternationalAvsResponseBankIdentifier[] — Bank identification codes
        - `type` 'BIC' | 'CLEARING_ID' | 'BANK_CODE' | 'SWIFT_CODE', required — BIC: Bank Identifier Code (SWIFT code) - used for most countries CLEARING_ID: Bank clearing system identifier BANK_CODE/SWIFT_CODE: Bank code identifier - used for AVS API
        - `value` string, required — Bank identifier value
    - `account_status` string, required — Current status of the account
    - `account_holder_name` string, nullable — Name of the account holder
    - `account_currency` string, nullable — ISO 3-letter currency code
    - `verification_method` string, required — Method used for verification

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/leantech/apis/auth.md) · [All operations](https://skmtc.net/leantech/apis/auth/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leantech/auth/revisions/c2e46d54d886/schema)