Search
K
Swiss Bank Master API [CH]

GET IBAN information

Validates the international bank account number (IBAN) and returns detail information if available.

get

Query Parameters

ibanstringrequired

International bank account number (IBAN) parameter of the API call.

>= 10 characters<= 100 characters

Response

application/json

IBAN information

IbanResponse

IBAN validation result and IID if available.

validationResultstringrequired

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)
iidinteger

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

get/iban
  
curl --request GET \
  --url 'https://api.six-group.com/api/epcd/bankmaster/v3/iban?iban=' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json'
application/json
{
  "validationResult": "validationResult",
  "iid": 9703
}

healthcheck

System Healthcheck
This allows to check the basic state of the API (can it be reached, does it respond).

Health check using GET method

Returns a status message of the system.

get

Response

application/json

Healthcheck successful

HealthCheckResponse

messagestringrequired

Response message from health check.

<= 100 characters

Example:The health check GET request was successfully received and processed.

requestDateTimestring(date-time)required

According to RFC3339, section 5.6 in ISO 8601 with timezone and milliseconds.

Example:2023-01-21T10:52:05.1904957+01:00

receivedHeadersarray[object]required
Show Child Parameters
environmentStagestringrequired

The instance to which the request was sent to.

Example:X1

applicationVersionstringrequired

The version of the API backend.

Example:4.5.0-julia

apiVersionstringrequired

The version of the API.

Example:1.0.23

get/healthcheck
  
curl --request GET \
  --url https://api.six-group.com/api/epcd/bankmaster/v3/healthcheck \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json'
application/json
{
  "message": "The health check GET request was successfully received and processed.",
  "requestDateTime": "2023-01-21T10:52:05.1904957+01:00",
  "receivedHeaders": [
    {
      "headerName": "Accept",
      "headerValue": "application/json"
    }
  ],
  "environmentStage": "X1",
  "applicationVersion": "4.5.0-julia",
  "apiVersion": "1.0.23"
}

Health check using GET method (only head, no content)

Returns a status message of the system (only head, no content).

head

Response

Content can be downloaded with GET method.

head/healthcheck
  
curl --request HEAD \
  --url https://api.six-group.com/api/epcd/bankmaster/v3/healthcheck \
  --header 'Content-Type: application/json'
Content can be downloaded with GET method.

BankMasterJsonResponse

object
totalSizeintegerrequired

The total count of records in the entries list.

validOnstring(date)required

Master data is edited and published on a daily basis. Therefore the data is valid on that exact date only.

Example:2023-01-23

readTimestring(date-time)required

Date and time (according to ISO 8601) at which this response was created.

Example:2023-01-21T10:52:05.1904957+01:00

entriesarray[object]required
Show Child Parameters
Example
{
  "totalSize": 0,
  "validOn": "2023-01-23",
  "readTime": "2023-01-21T10:52:05.1904957+01:00",
  "entries": [
    {
      "iid": 9703,
      "validOn": "2023-01-23",
      "entryType": "BankMasterConcatenated"
    }
  ]
}