---
title: "IbanResponse"
url: "https://apiportal.six-group.com/apis/swiss-bank-master-api-ch-v3/versions/e41bfa39-0a9c-4f08-95bc-081de1a37f9f/schemas/IbanResponse"
---

> Full API specification: https://apiportal.six-group.com/apis/swiss-bank-master-api-ch-v3/versions/e41bfa39-0a9c-4f08-95bc-081de1a37f9f.md

# IbanResponse

IBAN validation result and IID if available.

## OpenAPI definition

```yaml
openapi: 3.0.2
info:
  title: Swiss Bank Master API v3
  version: 3.1 (generated 2025-12-05T07:26:41Z)
servers:
  - url: https://api.six-group.com/api/epcd/bankmaster/v3
  - url: https://api.p2p.six-group.com/api/epcd/bankmaster/v3
  - url: https://api.fip.six-group.com/api/epcd/bankmaster/v3
components:
  schemas:
    IbanValidationResult:
      type: string
      description: >
        Validation result. Possible values:

        - OK                    # This IBAN is formally correct

        - INVALID_COUNTRY_CODE  # This IBAN has an invalid country code

        - INVALID_LENGTH        # This IBAN has an invalid length

        - INVALID_FORMAT,       # This IBAN is formally incorrect according to
        ISO-13616-1

        - INVALID_CHECKSUM      # This IBAN has an invalid checksum

        - INVALID_IID           # This IBAN has an invalid CH or LI institution
        identification (IID)
    IbanResponse:
      required:
        - validationResult
      type: object
      properties:
        validationResult:
          $ref: "#/components/schemas/IbanValidationResult"
        iid:
          type: integer
          description: Each bank / financial institution is identified by an IID
            (institution identification). IIDs are three to five digits long.
            QR-IIDs consist exclusively of numbers from 30000 to 31999.
          example: 9703
      description: IBAN validation result and IID if available.
```