Skip to main content

Release of AIS v3

· 2 min read
Simon Meyer
Simon Meyer
Product Manager @ bLink

AIS Version 3.1​

Welcome to the release notes of the major version 3 of the Account Information Service API!

Here you can find all relevant information about updates, improvements and new features introduced in this version.

Release​

  • XE/XP: 07/2023
  • Prod: 11/2023

Added​

  • New status code 202 added to endpoints /balance and /transactions.
  • New status code 204 added to endpoints /balance and /transactions
Defined AIS behavior

Expected behavior for AIS when retrieving data via JSON endpoints:

  • Technical correct requests return always a successful status 20X
  • Requests for transactions or balance for specific days without any data are always returned with either
    • 200 + empty list of transactions / 200 + last available balance
    • 204 + without content
  • Requests for transactions or balance for specific days that have not yet completed the day-end-process return a 202

Changes in YAML​

  '/accounts/{accountId}/balance':
    get:
      tags:
      ...
      responses:
        '200':
          description: Account balance information of the specified account.
          headers:
            X-Correlation-ID:
              $ref: '#/components/headers/X-Correlation-ID'
            X-CorAPI-Source:
              $ref: '#/components/headers/X-CorAPI-Source'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/accountBalanceItem'
+       '202':
+         $ref: '#/components/responses/standard202'
+       '204':
+         $ref: '#/components/responses/standard204'
        '400':
          $ref: '#/components/responses/standard400'
          ...

  '/accounts/{accountId}/transactions':
    get:
      ...
      responses:
        '200':
          description: Returns transactions of an account.
          headers:
            X-Correlation-ID:
              $ref: '#/components/headers/X-Correlation-ID'
            X-CorAPI-Source:
              $ref: '#/components/headers/X-CorAPI-Source'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/accountTransactionReport'
+       '202':
+         $ref: '#/components/responses/standard202'
+       '204':
+         $ref: '#/components/responses/standard204'
        '400':
          $ref: '#/components/responses/standard400'   
          ...     

   responses:
   ...
+   standard202:
+     headers:
+       Content-Type:
+         $ref: '#/components/headers/Content-Type'
+       Content-Language:
+         $ref: '#/components/headers/Content-Language'
+       X-Correlation-ID:
+         $ref: '#/components/headers/X-Correlation-ID'
+       X-CorAPI-Source:
+         $ref: '#/components/headers/X-CorAPI-Source'
+     description: |
+       Accepted - Valid request, requested data not available yet. The request may be attempted at a later time.
+     content:
+       application/json:
+         schema:
+           type: object
+           # properties: ??

+   standard204:
+     headers:
+       X-Correlation-ID:
+         $ref: '#/components/headers/X-Correlation-ID'
+       X-CorAPI-Source:
+         $ref: '#/components/headers/X-CorAPI-Source'
+     description: |
+       No content - The server has successfully fulfilled the request. There is no content to return and never will be.
        ...

AIS Version 3.0​

Welcome to the change log for the Account Information Service API version 3, where you can find information about updates, improvements, and new features introduced in this version.

Release​

  • XE/XP: 06/2022
  • Prod: 11/2022

Changed​

  • Support of XML-Schema changed from camt.053.001.04 to camt.053.001.08