# VIBAN Services

Virtual IBAN (VIBAN) services are a special solution for financial institutions to issue unique account numbers for their 3rd party customers in their name.

## Services

List of VIBAN management services:

[VIBAN Open](/home/connect/services/viban/open-a-viban-1.md)

[VIBAN Bulk Open](/home/connect/services/viban/open-a-viban-1-1.md)

[VIBAN Modify](/home/connect/services/viban/open-a-viban-1-2.md)

[VIBAN Info](/home/connect/services/viban/open-a-viban-1-3.md)

[VIBAN Close](/home/connect/services/viban/open-a-viban-1-4.md)

[VIBAN Notification](/home/connect/services/viban/open-a-viban-1-5.md)

## XML Formats

All our VIBAN services are using custom XML formats. The XSD definitions are lists separately under each service. Most of the XSD definitions are also using a common XSD file for different datatypes:

{% file src="/files/MxrxGnahHqedHKTLZxUM" %}
XML schema
{% endfile %}

## Errors

List of error codes for VIBAN services

#### Virtual IBAN Error Codes <a href="#virtual-iban-error-codes" id="virtual-iban-error-codes"></a>

<table><thead><tr><th>ErrorCode</th><th width="327">Description</th><th>Field</th></tr></thead><tbody><tr><td>'INVALID_REQUEST'</td><td>Invalid request.</td><td>-</td></tr><tr><td>'TECHNICAL_ERROR'</td><td>Technical error.</td><td>-</td></tr><tr><td>'FORBIDDEN'</td><td>Unauthorized master account.</td><td>&#x3C;MasterAccount></td></tr><tr><td>'FORBIDDEN'</td><td>Unauthorized virtual IBAN.</td><td>&#x3C;VirtualIBAN></td></tr><tr><td>'INVALID_ACCOUNT'</td><td>Account does not exist.</td><td>&#x3C;MasterAccount></td></tr><tr><td>'INVALID_BIRTH_DATE'</td><td>Birth date format is YYYY-MM-DD.<br>Birth date cannot be in the future.</td><td>&#x3C;BirthDate></td></tr><tr><td>'INVALID_COUNTRY'</td><td>Unknown country.</td><td>&#x3C;BirthCountry><br>&#x3C;Residency><br>&#x3C;CountryOfOrigin><br>&#x3C;TaxResidency><br>&#x3C;Country></td></tr><tr><td>'INVALID_STATUS'</td><td>Virtual IBAN has to be in ACTIVE / PENDING / BLOCKED status.<br>Virtual IBAN has to be in ACTIVE / PENDING / ON_HOLD status.</td><td>&#x3C;VirtualIBAN></td></tr><tr><td>'INVALID_VIBAN'</td><td>Virtual IBAN does not exist.</td><td>&#x3C;VirtualIBAN></td></tr><tr><td>'MASTER_ACCOUNT_AGREEMENT_MISSING'</td><td>Active master account agreement is missing.</td><td>&#x3C;MasterAccount></td></tr><tr><td>'INVALID_REASON'</td><td>Reason for the change is missing.<br>Reason for the change is not allowed when status is PENDING.</td><td>&#x3C;ModifyReason></td></tr><tr><td>'INVALID_USER_TYPE'</td><td>Changing user type is not allowed.</td><td>&#x3C;User></td></tr><tr><td>'INVALID_CLIENT_REFERENCE'</td><td>Client reference number must be unique.<br>Client reference number change is not allowed.</td><td>&#x3C;ClientReference></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.lhv.com/home/connect/services/viban.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.