WELCOME TO THE DEVELOPERS’ SECTION

If you are curious about our API or you are a partner wishing to integrate with us, this is the place to be. Find the REST API documentation and other resources that you need to be up and running in no time.

To obtain client test certificates for accessing the test environment, please send an e-mail to onboarding@frejaeid.com. If you have any other questions about integration, please contact partnersupport@frejaeid.com.

API & DOCS

REST API

In-depth documentation describing the Freja eID REST API including a starter guide.

Rest API Guide

API CLIENT LIBRARY

Java client library that will help you get up and started in no time.

API Client Library
GitHub link

API CLIENT LIBRARY (DEPRECATED)

The old library will be available until 30 June, but as of version 3.9.0 will no longer be maintained.

Client Library Guide
Download Guide
Download jar

FREJA eID AZURE IdP INTEGRATION

Interested in the integration between Freja eID and Office 365? We have prepared a short guide to help you through it.

Freja eID Azure Integration Guide

TESTING INSTRUCTIONS

Try Freja eID! Learn how to use the Freja eID mobile app in Test Mode.

Test Instructions

RELEASE NOTES

Freja eID is constantly undergoing changes and improvements. See the latest ones here.

Release Notes

WELCOME PACK

Are you a Freja eID partner? Then this Welcome Pack, packed with essential information, will surely come in handy.

Welcome Pack
Download Freja eID Logo

FAQ

Got a technical issue? Maybe our developer FAQs can help!

For all other question please see end user FAQs.

HOW TO INTEGRATE WITH US

Our system offers two environments. The Test Environment, as its name implies, is intended for testing purposes. The Production Environment is where Freja eID services are available for your real users and business purposes.

Our system uses SSL/TLS certificates to verify your authenticity. There are different client certificates for the Test and Production Environments. To get them, get in touch with us at partnersupport@frejaeid.com

More information about our API, importing certificates and other details can be found in our documentation.

DEVELOPER FAQ

In the following section, you will find troubleshooting for some different scenarios you might encounter during the integration.

I AM UNABLE TO ESTABLISH THE SSL CONNECTION AGAINST FREJA eID TEST OR PRODUCTION ENVIRONMENT

Freja eID services require the SSL connection with both client and server SSL certificate verification. To establish the SSL connection, both client and server SSL certificate need to be configured in your application truststore/keystore. Contact our support to check that you have received proper client and server SSL certificates.

ERRORS IN THE FREJA eID MOBILE APPLICATION

Contact Freja eID support and provide them with the error code displayed in the Freja eID application.

THE SERVER RETURNS ERROR 404 (RESOURCE NOT FOUND)

Check the service URL you are using. The service URLs for all Freja eID services are documented in Freja eID Relying Party Developers’ Documentation under corresponding sections (refer to sections dedicated to Authentication services, Signature services or Custom identifier management respectively). If this doesn’t resolve your problem, contact Freja eID support.

I DON’T HAVE THE REQUIRED DOCUMENT/PERSONNUMMER TO TEST WITH

You don’t need to have the required document/personnummer for testing purposes. If you are testing/integrating our service, you can go to our Test Vetting Portal where you can auto-generate the data for testing purposes. This is explained in more detail in our Testing Instructions.

THE SERVER RETURNS ERROR 422 (UNPROCESSABLE ENTITY)

This HTTP error code indicates that Freja eID back end could not process your request for some reason. Contact our support and provide them with the full HTTP response text in order for them to identify the exact reason of the request failure.

All application error codes are described in Freja eID Relying Party Developers’ Documentation (refer to sections dedicated to Authentication services, Signature services or Custom identifier management respectively).

STAY UPDATED

Every few weeks we will summarize what is new, what has changed and what we fixed in Freja eID.

Our Release notes offer brief, high-level descriptions of enhancements and new features, covering changes in the API but also the user-visible changes in the Freja eID app and My Pages. We also include setup information, tips to help you get started, and best practices to ensure your continued success.