Advanced

Verify bank account ownership via IBAN

This endpoint is optional and not required for standard integrations. Use only if explicitly instructed by Wealth Reader. Allows verifying whether a natural or legal person is the holder of a specific bank account using the IBAN and the identification data of the alleged holder. It requires an api_key with the IBAN_OWNERSHIP product authorized. The initial request is sent with api_key, iban, document_type, document_number and holder_name. If the result returns status PENDING, the verification can be queried again by sending only api_key and session. NO_RESPONSE is a final error result: to retry, a new verification must be started without session.

post/verify/iban-ownership/

Request

  • Base URL: https://api.wealthreader.com
  • URL: https://api.wealthreader.com/verify/iban-ownership/
  • Auth: none declared

Response

Verification result

successboolean required

Example response

{
  "success": true,
  "payload": {
    "iban_ownership": {
      "ownership": true,
      "status": "CONFIRMED",
      "result": "La titularidad del IBAN ha sido confirmada."
    }
  },
  "statistics": {
    "execution_time": 0.958119869232178,
    "warnings": [
      {
        "code": 1000,
        "message": "No contracted funds",
        "product_type": "portfolios"
      }
    ],
    "operation_id": "1827C79229",
    "token": "FRJ0mHlaqZwLzu"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.