For testing the XS2A-API the Postman-Collection can easily be used.


  • Postman version >=6.x, verify with Help -> Check for updates
  • An access_token that needs to be put into the environment

Import Playground environment

For a fresh installation, import the playground environment file first. Follow the steps below.

Import collection

For a fresh import of the collection, but also for updating, follow the steps below.

Configure Playground environment

After the import was successful, configure a user for the environment.

  • Click on the gear icon at the very top right below the header line
  • A new window opens up with the title "manage environments"
  • Click on the KOB Playground text
  • Change the initial and current value of the access_token from --- insert token here --- to a valid token that can be obtained from
  • Click on the Update button

Using the collection

Before starting a session, always ensure that the correct environment (see Import Playground environment) is selected at the top right. When used the collection sets several "runtime variables" in the active environment. To prevent messing up other environments, there is a pre-request-script configured, which verifies that your chosen environment starts with KOB, otherwise it will show an error like There was an error in evaluating the Pre-request Script: Error: Invalid environment selected.

When testing a transfer please bear in mind that you need to fill out the needed details in the JSON-body of the transfer-object.

Updating the collection

To ensure that we always provide the latest features in the Postman-collection there is an integrated update-check. If you see an error like There was an error in evaluating the Pre-request Script: Error: Please get the new collection from you currently use: v1 and the latest version is v2 it means that the collection was released in a new version. The update-process is made up of removing the collection and importing it again. The environment does not need to be deleted.

results matching ""

    No results matching ""