Skip to main content
Version: v2

Introduction

Important information

From May 1 2024 it will no longer be possible to initiate an auth or sign request using SSN. Only animated QR-code or autostart on same device will be allowed due to new BankID requirements. https://www.bankid.com/en/foretag/secure-start.

API V2 will remain operational but requires the use of autostart or animated QR.

IDkollen API V3 will be released on January 1 2024. API V3 will support new functionality from BankID. We strongly recommend that you use API V3 for new implementations or migrate existing implementations.

IDkollen provides a JSON/REST API for authenticating and signing with BankID.

The API is only accessible with SSL and a unique key provided by IDkollen. The key is private and should not be shared with a third party. The API should only be called from a server application, not directly from the client.

When signing up you will receive API keys for IDKollens staging and live environment.

EnvironmentURL Callback IP BankID environment
Livehttps://api.idkollen.se/v2/13.53.114.219
13.48.243.11
Live
Staginghttps://stgapi.idkollen.se/v2/13.53.56.116
13.53.92.159
Test

Usage flow

  1. The user initiates an authentication via the partner's interface.
  2. The partner calls IDkollen's API with the secret key to get to initiate an authentication.
  3. IDkollen sends response to partner with information about the initiated authentication.
  4. The answer from IDkollen is displayed to the user by the partner.
  5. The user identifies him- or herself with BankID.
  6. IDkollen sends the result to the partners callback endpoint.

Staging environment (test)

Please note that the Staging environment only works with Test BankID: https://www.bankid.com/en/utvecklare/test/skaffa-testbankid/test-bankid-get

Callback URL

If you'd prefer not to supply the callbackUrl in the Authentication request, you can supply us with a callbackUrl that the responses from us will default to. To do so, email us at support@idkollen.se.

Secret key

To initiate requests to the API a secret key is needed. To request a secret key, contact support@idkollen.se.

More information

For more information about error messages and how the BankID API works in general, please refer to the BankID Relying Party Guidelines.

If you have any questions, please contact us at support@idkollen.se