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

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

# BankMaster

## 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:
    BankMasterBase:
      required:
        - entryType
        - iid
        - validOn
      type: object
      properties:
        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
        validOn:
          type: string
          description: Date to which the information in a record applies. This date
            (written as per ISO8601 standard) is identical for all records.
          format: date
          example: 2023-01-23
        entryType:
          type: string
          description: '"New IID/QR-IID" must be used instead of "IID / QR-IID" if
            entryType is BankMasterConcatenated.'
          example: BankMaster
          enum:
            - BankMasterConcatenated
            - BankMaster
      discriminator:
        propertyName: entryType
    BankMaster:
      type: object
      allOf:
        - $ref: "#/components/schemas/BankMasterBase"
        - required:
            - bankOrInstitutionName
            - countryCode
            - euroSicParticipation
            - ipCustomerPaymentsChf
            - lsvBddChfParticipation
            - lsvBddEurParticipation
            - place
            - rtgsCustomerPaymentsChf
            - sicParticipation
            - zipCode
          properties:
            sicIid:
              maxLength: 6
              minLength: 6
              type: string
              description: This is always a 6-digit number and may be used only by SIC and
                euroSIC participants.
              example: "097031"
            headQuarters:
              type: integer
              description: IID of the headquarters of this participant. If this is the record
                of the headquarters itself, then this field contains the same
                value as the field IID.
              example: 9703
            iidType:
              type: string
              description: Provides information as to the respective type of entry.
              example: HEADQUARTERS
              enum:
                - HEADQUARTERS
                - MAIN_BRANCH
                - QR_IID
            qrIidBelongsTo:
              type: integer
              description: IID of the bank/financial institution to which this QR IID is
                assigned to. It only contains a value, if the field iidType
                contains a QR_IID. Otherwise the field is empty.
              example: 9950
            bankOrInstitutionName:
              maxLength: 60
              minLength: 1
              type: string
              description: >
                Name of participant

                Notice:

                + at the beginning of the name of the bank/institution = in
                liquidation

                ++ at the beginning of the name of the bank/institution =
                alternation of purpose
              example: Schweizerische Nationalbank
            streetName:
              maxLength: 35
              type: string
              description: Street of domicile address
              example: Bundesplatz
            buildingNumber:
              maxLength: 16
              type: string
              description: Building number of domicile address
              example: 55a
            postCode:
              maxLength: 16
              minLength: 1
              type: string
              description: Zip code/postcode
              example: "3003"
            townName:
              maxLength: 35
              minLength: 1
              type: string
              description: City
              example: Bern
            country:
              maxLength: 2
              type: string
              description: 2-digit alphabetical country code according to the ISO standard
                3166.
              example: DE
            bic:
              maxLength: 11
              minLength: 11
              type: string
              description: BIC Formatted (XXXXXXXXXXX) (= 11-digit)
              example: SNBZCHZZXXX
            sicParticipation:
              type: boolean
              description: Participation in SIC.
              example: true
            rtgsCustomerPaymentsChf:
              type: boolean
              description: Available for RTGS customer payments.
              example: true
            ipCustomerPaymentsChf:
              type: boolean
              description: Available for IP customer payments.
              example: true
            euroSicParticipation:
              type: boolean
              description: Participation in euroSIC.
              example: true
            lsvBddChfParticipation:
              type: boolean
              description: Participation in LSV+/BDD in CHF (as debtor FI).
              example: true
            lsvBddEurParticipation:
              type: boolean
              description: Participation in LSV+/BDD in EUR (as debtor FI).
              example: true
```