---
title: "Create Bank Account Validation"
method: POST
path: "/"
tags: ["Bank Account Validation"]
---

# Create Bank Account Validation

`POST /`

## Request

- Base URL: `https://app2test.infiniaweb.com/infinia_api/v1/bank-account-validation`
- URL: `https://app2test.infiniaweb.com/infinia_api/v1/bank-account-validation/`
- Auth: HTTP basic

Create a bank account validation request. The response will contain the validation request ID which you can use later to retrieve the result. The validation process may take a few seconds.<br><br>If you are interested in any other country kindly reach out to us as we're continuosly expanding our coverage.

## Headers

- `x-company-id` integer: ID of a child company for authentication. If not provided, the parent company will be authenticated.

## Request body

- union
  - AccountIdentityRequestArgentina
    - `country` 'AR', required: Country
    - `account` union, required: Account data to validate
      - AccountAlias
        - `dataType` 'ALIAS', required
        - `alias` string, required: Alias of the account to validate.<br>Example: CALOR.ASPIRADORA.CUADRO
      - AccountCBU
        - `dataType` 'CBU', required
        - `cbu` string, required: CBU of the account to validate.<br>Example: 2850590940090418130001
      - AccountCVU
        - `dataType` 'CVU', required
        - `cvu` string, required: CVU of the account to validate.<br>Example: 0000003100040000000015
      - AccountQRCode
        - `dataType` 'QR_CODE', required
        - `qrCode` string, required: Raw QR code string to validate.
    - `callbackUrl` string: This url must be supported method POST
  - AccountIdentityRequestBangladesh
    - `country` 'BD', required: Country
    - `account` SrcApiBankAccountValidationAllSchemasBdSchemaAccountSWIFT, required
      - `dataType` 'SWIFT_BD', required
      - `number` string, required: Account number <br>Example: 111112222201
      - `swiftCode` string, required: SWIFT code of the bank where the account is located.<br>Example: MTBLBDDH<br>[Complete list of SWIFT codes](https://www.theswiftcodes.com/Bangladesh/)
      - `ownerName` string: Account owner name
  - AccountIdentityRequestBrazil
    - `country` 'BR', required: Country
    - `account` union, required: Account data to validate
      - BrazilAccountWithBranchNumber
        - `dataType` 'ACCOUNT_NUMBER_WITH_BRANCH_NUMBER_BR', required
        - `number` string, required: Account number.<br>Example: 01323555513
        - `branchNumber` string, required: Branch number.<br>Example: 00001
        - `ispbCode` string, required: [Complete list of bank codes ](https://docs.infiniaweb.com/page/br-bank-codes)
        - `type` 'CACC' | 'TRAN' | 'SVGS' | 'SLRY', required: Account type code. See [complete list](https://docs.infiniaweb.com/page/br-account-types)
        - `ownerDocument` string, required: Account owner document (CPF/CNPJ), only numbers.<br>Example: 12345678901
        - `ownerName` string: Account owner name.
        - `retrieveOwnerData` boolean: If set to true, Infinia will check with a partner data bureau to get the info. This may have additional costs.
      - AccountPixKey
        - `dataType` 'PIX_KEY', required
        - `pixKey` string, required: Pix key of the account to validate, which can be a CPF/CNPJ, email, phone number or random key. <br>If the key is a CPF/CNPJ, only numbers are accepted. If the key is a phone number, it must be in international format and include the leading +.<br>Example: +5512575253111
        - `ownerDocument` string: Owner CPF/CNPJ. If this field is passed, a verification is triggered between the document and the chave pix, giving an error if the document does not correspond to the chave pix
        - `retrieveOwnerData` boolean: If set to true, Infinia will check with a partner data bureau to get the info. This may have additional costs.
      - BrazilQRCode
        - `dataType` 'QR_CODE', required
        - `qrCode` string, required: Pix BR Code to validate (the QR payload, also known as Pix copia e cola). Static and dynamic QRs are supported.
    - `callbackUrl` string: This url must be supported method POST
  - AccountIdentityRequestChina
    - `country` 'CN', required: Country
    - `account` ChinaAccountNumber, required
      - `dataType` 'ACCOUNT_NUMBER_CN', required
      - `number` string, required: Account number <br>Example: 6212345678987654321
      - `ownerName` string: Account owner name (in Chinese characters). Example: 周杰伦
  - AccountIdentityRequestColombia
    - `country` 'CO', required: Country
    - `account` union, required: Account data to validate (ACH account, Bre-B key)
      - AccountBreBKey
        - `dataType` 'BREB_KEY', required
        - `brebKey` string, required: Bre-B key value
      - AccountACH
        - `dataType` 'ACH', required
        - `fullName` string, required: Full legal name of the account holder as registered with the bank
        - `documentType` 'CC' | 'NIT' | 'CE' | 'PA' | 'PPT' | 'TI' | 'RC' | 'TE' | 'DIE' | 'ND', required: Type of identification document of the account holder (e.g., CC for citizens, NIT for companies).
        - `documentNumber` string, required: Identification number corresponding to the provided document type. Only digits are accepted: no dots, commas, dashes or spaces. A NIT may be sent with or without its check digit.
        - `bankCode` integer, required: Bank code of the beneficiary’s account. See the full list at https://docs.infiniaweb.com/page/co-bank-codes
        - `accountType` 'CHECKING' | 'SAVINGS' | 'ELECTRONIC_DEPOSIT', required
        - `accountNumber` string, required: Beneficiary account number
    - `callbackUrl` string: This url must accept a method POST
  - AccountIdentityRequestIndia
    - `country` 'IN', required: Country
    - `account` IndiaAccountWithBranchNumber, required
      - `dataType` 'ACCOUNT_NUMBER_WITH_BRANCH_NUMBER_IN', required
      - `number` string, required: Account number.<br>Example: 123456789007
      - `ifscCode` string, required: IFSC code of the bank to validate. [Complete list of codess](https://ifsclist.com/).<br>Example: ALLA0211480
      - `ownerName` string: Account owner name. Example: DUMMY BENEFICIARY NAME
  - AccountIdentityRequestIndonesia
    - `country` 'ID', required: Country
    - `account` SrcApiBankAccountValidationAllSchemasIdSchemaAccountSWIFT, required
      - `dataType` 'SWIFT_ID', required
      - `number` string, required: Account number <br>Example: 1122334455
      - `swiftCode` string, required: SWIFT code of the bank where the account is located.<br>Example: CENAIDJA<br>[Complete list of SWIFT codes](https://www.theswiftcodes.com/indonesia/)
      - `ownerName` string: Account owner name. Example: FIRA DIYANKA
  - AccountIdentityRequestMexico
    - `country` 'MX', required: Country
    - `account` AccountClabe, required
      - `dataType` 'CLABE', required
      - `clabe` string, required: CLABE of the account to validate.<br>Example: 021060040538028986
    - `callbackUrl` string: This url must be accept a method POST
  - AccountIdentityRequestNepal
    - `country` 'NP', required: Country
    - `account` SrcApiBankAccountValidationAllSchemasNpSchemaAccountSWIFT, required
      - `dataType` 'SWIFT_NP', required
      - `number` string, required: Account number <br>Example: 1234567891234001
      - `swiftCode` string, required: SWIFT code of the bank where the account is located.<br>Example: NICENPKA<br>[Complete list of SWIFT codes](https://www.theswiftcodes.com/nepal/)
      - `ownerName` string: Account owner name. Example: ANIL GURUNG
  - AccountIdentityRequestNigeria
    - `country` 'NG', required: Country
    - `account` SrcApiBankAccountValidationAllSchemasNgSchemaAccountSWIFT, required
      - `dataType` 'SWIFT_NG', required
      - `number` string, required: Account number <br>Example: 1234567890
      - `swiftCode` string, required: SWIFT code of the bank where the account is located.<br>Example: GTBINGLA<br>[Complete list of SWIFT codes](https://www.theswiftcodes.com/nigeria/)
      - `ownerName` string: Account owner name. Example: DAVID OYELOWO
  - AccountIdentityRequestPakistan
    - `country` 'PK', required: Country
    - `account` union, required: Account data to validate
      - SrcApiBankAccountValidationAllSchemasPkSchemaAccountSWIFT
        - `dataType` 'SWIFT_PK', required
        - `number` string, required: Account number (16 digits) <br>Example: 03097524704
        - `swiftCode` string, required: SWIFT code of the bank where the account is located.<br>Example: EASYPAISA<br>[Complete list of SWIFT codes](https://www.theswiftcodes.com/pakistan/)
        - `ownerName` string: Account owner name. Example: HASSAN IQBAL
      - AccountIBAN
        - `dataType` 'IBAN_PK', required
        - `iban` string, required: IBAN of the account to validate.<br>Example: PK35HABB0001111222212345
        - `ownerName` string: Account owner name. Example: KAMALA KHAN
  - AccountIdentityRequestPeru
    - `country` 'PE', required: Country
    - `account` union, required: Account data to validate
      - PeruCCI
        - `dataType` 'ACCOUNT_NUMBER', required
        - `number` string, required: 20-digit CCI of the account to validate.<br>Example: 00210300000012345678
      - PeruQRCode
        - `dataType` 'QR_CODE', required
        - `qrCode` string, required: Raw QR code string to validate.
      - PeruPhoneNumber
        - `dataType` 'PHONE_NUMBER', required
        - `mobilePhone` string, required: Mobile phone number in international format, without the leading +.<br>Example: 51987654321
    - `callbackUrl` string: This url must be supported method POST
  - AccountIdentityRequestSouthKorea
    - `country` 'KR', required: Country
    - `account` SrcApiBankAccountValidationAllSchemasKrSchemaAccountSWIFT, required
      - `dataType` 'SWIFT_KR', required
      - `number` string, required: Account number <br>Example: 11112222321
      - `swiftCode` string, required: SWIFT code of the bank where the account is located.<br>Example: CZNBKRSE<br>[Complete list of SWIFT codes](https://www.theswiftcodes.com/south-korea/)
      - `ownerName` string: Account owner name (in Korean characters). Example: 송혜교
  - AccountIdentityRequestGreatBritain
    - `country` 'GB', required: Country
    - `account` AccountUK, required
      - `dataType` 'ACCOUNT_NUMBER_GB', required
      - `number` string, required: Account number (8 digits). <br>Example: 12345678
      - `sortCode` string, required: Sort code of the bank where the account is located (6 digits).<br>Example: 123456
      - `ownerName` string: Account owner name. Example: HARRY POTTER
  - AccountIdentityRequestUnitedStates
    - `country` 'US', required: Country
    - `account` AccountNumberWithRoutingNumber, required
      - `dataType` 'ACCOUNT_NUMBER_WITH_ROUTING_NUMBER', required
      - `number` string, required: Account number.<br>Example: 01323555513
      - `routingNumber` string, required: ABA/Routing number.<br>Example: 011700985
      - `currency` string: Account currency in ISO 4217 format
  - AccountIdentityRequestUruguay
    - `country` 'UY', required: Country
    - `account` union, required: Account data to validate
      - UruguayAccountNumber
        - `dataType` 'ACCOUNT_NUMBER_UY', required
        - `bankCode` string, required: [Complete list of bank codes ](https://docs.infiniaweb.com/page/uy-bank-codes)
        - `number` string, required: Account number to validate [following the bank's format](https://docs.infiniaweb.com/page/uy-bank-codes)
      - AccountPhoneNumber
        - `dataType` 'PHONE_NUMBER', required
        - `mobilePhone` string, required: Mobile phone number in international format, without the leading +.<br>Example: 59891234567
  - AccountIdentityRequestVietnam
    - `country` 'VN', required: Country
    - `account` SrcApiBankAccountValidationAllSchemasVnSchemaAccountSWIFT, required
      - `dataType` 'SWIFT_VN', required
      - `number` string, required: Account number <br>Example: 98765432100000
      - `swiftCode` string, required: SWIFT code of the bank where the account is located.<br>Example: VTCBVNVX<br>[Complete list of SWIFT codes](https://www.theswiftcodes.com/vietnam/)
      - `ownerName` string: Account owner name. Example: HANOI BUSINESS COMPANY

## Response `201`

The validation request was created successfully.

- UnifiedResponseWrapper
  - `status` 'success'
  - `data` UnifiedResponse, required
    - `id` string, required
    - `country` 'AR' | 'BD' | 'BR' | 'CN' | 'CO' | 'ES' | 'GB' | 'ID' | 'IN' | 'INTL' | 'KR' | 'MX' | 'NG' | 'NP' | 'PE' | 'PK' | 'US' | 'UY' | 'VN', required: Country
    - `createdAt` string, date-time, required: Record creation date
    - `updatedAt` string, date-time, required: Record update date
    - `inputData` object, required: Data entered to create the record
    - `status` 'SUCCESSFUL' | 'IN_PROGRESS' | 'ERROR' | 'TEMPORARY_FAILURE', required: Status of the validation process. <br> - SUCCESSFUL: The validation process ended correctly. The account was found and the associated data is available to query. It's up to the caller to validate if the data matches the expected values. <br> - IN_PROGRESS: The validation process is still in progress, keep querying for the result. <br> - ERROR: The validation process ended with an error. The account was not found and the associated data is not available to query. <br> - TEMPORARY_FAILURE: The validation process ended with an error. The error is temporary and you may retry it later.
    - `statusDescription` string: Verbose description/explanation of the status
    - `countryData` union: Country specific data obtained from the validation process
      - AccountIdentityResponseArgentina
        - `account` AccountDataArgentina, required
          - `number` string: Account number
          - `currency` 'ARS' | 'USD': Account currency
          - `type` 'CA' | 'CC' | 'WALLET': Account type
        - `owners` OwnerDataArgentina[], required: Owners information
          - `name` string: Account owner name
          - `type` 'NATURAL' | 'LEGAL': Account owner type
          - `documentType` 'DNI' | 'CUIT', required: Account owner document type
          - `documentNumber` string, required: Account owner document number
      - QRValidationResponseArgentina
        - `cuil` string: CUIL of the QR receiver
        - `cvu` string: CVU of the QR receiver
        - `amount` number: Amount of the QR (only for closed QRs)
        - `mcc` string: Merchant category code
        - `type` 'open' | 'closed': QR type
        - `holder` string: Name of the QR receiver
        - `accepter` string: QR accepter (only for closed QRs)
      - AccountIdentityResponseBangladesh
        - `matchScore` number: A numerical representation of the similarity between the provided owner name and the actual owner of the account.
      - AccountIdentityResponseBrazil
        - `account` AccountDataBrazil, required
          - `number` string: Account number
          - `type` 'SVGS' | 'CHCK' | 'CACC' | 'SLRY' | 'TRAN': Account type
          - `currency` 'BRL': Account currency in ISO 4217 format. Always BRL
          - `bankName` string: Bank name
          - `bankCode` string: Bank code in ISPB format
        - `owners` OwnerDataBrazil[], required: Owners information
          - `name` string: Account owner name
          - `type` 'NATURAL' | 'LEGAL': Account owner type
          - `documentType` 'CNPJ' | 'CPF': Account owner document type
          - `documentNumber` string: Account owner document number
          - `enrichedOwnerData` EnrichedOwnerDataBrazil
            - `ownerName` string: Account owner name
            - `dateOfBirth` string: Date of birth of the account owner, if a natural person. In the format YYYYMMDD
            - `isMinor` boolean: Indicates whether the account owner, if a natural person, is under the age of majority
            - `isDeceased` boolean: Indicates whether the account owner, if a natural person, is deceased
            - `dateOfDeath` string: Date when the account owner, if a natural person, passed away
      - QRValidationResponseBrazil
        - `type` 'static' | 'dynamic': QR type: static (the Pix key is in the QR) or dynamic (the QR points to a charge)
        - `pixKey` string: Pix key of the QR receiver (only for static QRs)
        - `amount` number: Amount of the QR, when it sets one
        - `expiration` string: Expiration of the charge (only for dynamic QRs)
        - `txid` string: Transaction identifier set in the QR (only for static QRs)
        - `holder` string: Name of the QR receiver, as registered in DICT
        - `holderDocument` string: CPF/CNPJ of the QR receiver, as registered in DICT. A CPF comes partially masked
        - `bankName` string: Bank of the QR receiver
        - `bankCode` string: Bank of the QR receiver in ISPB format
      - AccountIdentityResponseChina
        - `matchScore` number: A numerical representation of the similarity between the provided owner name and the actual owner of the account.
      - AccountIdentityResponseColombia
        - `account` AccountDataColombia, required
          - `number` string: Account number / key value
          - `accountHolderName` string: Account holder name
          - `accountHolderIdNumber` string: Account holder ID number
          - `bankCode` string: Code of the bank the account or key belongs to
          - `bankName` string: Name of the bank the account or key belongs to
        - `owners` OwnerDataColombia[], required: Owners information
          - `name` string: Account owner name
          - `type` 'NATURAL' | 'LEGAL': Account owner type
          - `documentType` string: Account owner document type (e.g. CC, NIT).
          - `documentNumber` string: Account owner document number
      - AccountIdentityResponseIndia
        - `account` AccountDataIndia, required
          - `number` string, required: Account number
          - `currency` string: Account currency in ISO 4217 format
        - `owners` OwnerDataIndia[], required: Owners information
          - `name` string, required: Account owner name
        - `matchScore` number: A numerical representation of the similarity between the provided owner name and the actual owner of the account.
      - AccountIdentityResponseIndonesia
        - `matchScore` number: A numerical representation of the similarity between the provided owner name and the actual owner of the account.
        - `owners` OwnerDataIndonesia[], required: Owners information
          - `name` string, required: Account owner name.
      - AccountIdentityResponseMexico
        - `account` AccountDataMexico, required
          - `number` string: Account number
          - `bankCode` string: Bank code
          - `bankName` string: Bank name
        - `owners` OwnerDataMexico[], required: Owners information
          - `name` string: Account owner name
          - `type` 'NATURAL' | 'LEGAL', required: Account owner type
          - `documentType` 'RFC' | 'CURP', required: Account owner document type
          - `documentNumber` string, required: Account owner document number
      - AccountIdentityResponseNepal
        - `matchScore` number: A numerical representation of the similarity between the provided owner name and the actual owner of the account.
        - `owners` OwnerDataNepal[], required: Owners information
          - `name` string, required: Account owner name
      - AccountIdentityResponseNigeria
        - `matchScore` number: A numerical representation of the similarity between the provided owner name and the actual owner of the account.
        - `owners` OwnerDataNigeria[], required: Owners information
          - `name` string, required: Account owner name
      - AccountIdentityResponsePakistan
        - `account` AccountDataPakistan, required
          - `currency` string: Account currency in ISO 4217 format
        - `owners` OwnerDataPakistan[], required: Owners information
          - `name` string, required: Account owner name
      - AccountIdentityResponsePeru
        - `account` AccountDataPeru, required
          - `number` string: CCI of the account
          - `currency` string: Account currency in ISO 4217 format
          - `type` 'SVGS' | 'CHCK': Account type
        - `owners` OwnerDataPeru[], required: Owners information
          - `name` string: Account owner name
          - `type` 'NATURAL' | 'LEGAL': Account owner type
          - `documentType` 'DNI' | 'RUC' | 'CE' | 'PAS': Account owner document type
          - `documentNumber` string: Account owner document number
      - QRValidationResponsePeru
        - `cci` string: CCI the QR credits
        - `holder` string: Name of the QR receiver
        - `amount` number: Amount of the QR (only for closed QRs)
        - `currency` string: Currency of the QR in ISO 4217 format
        - `mcc` string: Merchant category code
        - `type` 'open' | 'closed': QR type
      - AccountIdentityResponseSouthKorea
        - `matchScore` number: A numerical representation of the similarity between the provided owner name and the actual owner of the account.
        - `account` AccountDataSouthKorea, required
          - `currency` string: Account currency in ISO 4217 format
        - `owners` OwnerDataSouthKorea[], required: Owners information
          - `name` string, required: Account owner name
          - `nameTranslation` string, required: Account owner name translation
      - AccountIdentityResponseGreatBritain
        - `account` AccountDataGreatBritain, required
          - `currency` string: Account currency in ISO 4217 format
        - `owners` OwnerDataGreatBritain[], required: Owners information
          - `name` string, required: Account owner name (only returned if an ownerName was provided and it partially matches the owner name in the bank)
      - AccountIdentityResponseUnitedStates
        - `account` AccountDataUnitedStates
          - `number` string: Account number
          - `routingNumber` string: Routing number
        - `owners` OwnerDataUnitedStates[]: Owners information
          - `name` string: Account owner name
      - AccountIdentityResponseUruguay
        - `account` AccountDataUruguay, required
          - `number` string: Account number
          - `currency` string: Account currency in ISO 4217 format
          - `type` 'SVGS' | 'CHCK': Account type
        - `owners` OwnerDataUruguay[], required: Owners information
          - `name` string: Account owner name
          - `type` 'NATURAL' | 'LEGAL': Account owner type
          - `documentType` 'CI' | 'RUT' | 'PASSPORT': Account owner document type
          - `documentNumber` string: Account owner document number
      - AccountIdentityResponseVietnam
        - `matchScore` number: A numerical representation of the similarity between the provided owner name and the actual owner of the account.
        - `account` AccountDataVietnam, required
          - `currency` string: Account currency in ISO 4217 format
        - `owners` OwnerDataVietnam[], required: Owners information
          - `name` string, required: Account owner name

## Other responses

- `400`: A validation request could not be created due to invalid data.
- `401`: Unauthorized. The request is missing the required authentication credentials.
- `403`: Forbidden. The country or the bank account validation product is not enabled for your company.
- `422`: Validation Error
- `500`: Internal server error.

---

[API](https://skmtc.dev/infiniaweb/apis/bank-account-validation.md) - [All operations](https://skmtc.dev/infiniaweb/apis/bank-account-validation/llms.txt) - [OpenAPI document](https://skmtc.dev/infiniaweb/apis/bank-account-validation/revisions/a5867efd335e?raw)