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.

Read

FREJA eID CLIENT

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

Read
Download

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.

Read
Download doc
Download jar

TEST INSTRUCTIONS

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

Read

WELCOME PACK

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

Read
Download Freja eID Logo

FAQ

Got an issue that is technical in nature? Maybe our FAQs can help!

For our other FAQs please see here.

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.

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.