Auðkenni signing
Auðkenni is the national electronic ID of Iceland. It is available as the Auðkenni App (a smartphone application) and Auðkenni Mobile ID (SIM-based).
The AUDKENNI signing method creates certificate-based electronic signatures with either method through the Sign API v2 public key infrastructure (PKI) signing flow, PKISIGNING. The signer chooses their method on the signing page, so you can offer both methods with one vendor value.
Our authentication documentation refers to these methods as Auðkennisappið and Skilríki á síma.
Supported capabilities
Signature level
Auðkenni PKISIGNING produces a Qualified Electronic Signature (QES) in PDF Advanced Electronic Signatures (PAdES) BASELINE-LT format. The signed PDF embeds an authoritative signature timestamp and validation material (certificates and revocation data) for long-term (LT) validation.
Sandbox signatures use Auðkenni test certificates, which are non-qualified.
For certificate details, see the Auðkenni certificate profiles (AK-CPR V1.8).
Signing setup
To request Auðkenni, set signingSetup[].vendor to AUDKENNI and signingFlow to PKISIGNING in your HTTP POST request to the Signing sessions endpoint.
Include this configuration in the request body:
{
"signingSetup": [
{
"vendor": "AUDKENNI",
"signingFlow": "PKISIGNING",
"requestedAttributes": ["nin"]
}
]
}
On the signing page, the signer first chooses the Auðkenni App or Auðkenni Mobile ID. They then enter their personal code for the app or their phone number for Mobile ID.
For the complete signing session creation and document upload process, see our Sign API v2 integration guide.
Signer attributes
To request the national identity number as a separate output.userInfo.nin field, include nin in the requestedAttributes array.
The uniqueId attribute contains the signer's national identity number (kennitala), even when you omit nin from requestedAttributes. Treat uniqueId as personal data when processing or storing it.
Auðkenni certificates do not provide dateOfBirth. Requesting it does not fail, but the attribute is absent from the result.
Attribute response
When the signing session is complete, output.userInfo contains the retrieved attributes:
Restrict signing to a known person
To require a particular national identity number, include nin in signingSetup[].requestedAttributes and configure the signer object in the body of your HTTP POST request to the Signing sessions endpoint:
{
"signer": {
"nationalIdentificationNumber": "0101309999",
"prefill": [],
"validations": ["NATIONAL_IDENTIFICATION_NUMBER"]
},
"signingSetup": [
{
"vendor": "AUDKENNI",
"signingFlow": "PKISIGNING",
"requestedAttributes": ["nin"]
}
]
}
The signing session is rejected if the national identity number returned by Auðkenni differs from the configured value. Setting nationalIdentificationNumber without "validations": ["NATIONAL_IDENTIFICATION_NUMBER"] does not enforce a match.
Pre-authentication with Auðkenni
To pre-authenticate with Auðkenni, use audkenni-app or audkenni-mobileid as the idpName. To offer both methods, include both identity providers:
{
"signingSetup": [
{
"vendor": "AUDKENNI",
"signingFlow": "PKISIGNING"
}
],
"preAuthentication": {
"enabled": true,
"identityProviders": [
{ "idpName": "audkenni-app" },
{ "idpName": "audkenni-mobileid" }
]
}
}
When preAuthentication.identityProviders is omitted, all identity providers configured on the account are offered.
If national identity number validation is requested, the pre-authentication and signing identity providers must resolve to the same national identity. Otherwise, the signing session is rejected with a national identity number mismatch.
Signing result
A completed signing session contains one PAdES result (PAdES-BASELINE-LT) for each signed input document:
{
"lifecycle": {
"state": "SIGNED",
"stateIsFinal": true
},
"output": {
"signatures": [
{
"resultDocumentId": "01a14494-ba1d-7ab7-ba49-2338efe1aebb",
"originalDocumentId": "01a14492-926f-7d89-b182-4addfbbd94c4",
"signatureType": "PADES"
}
],
"packages": [],
"userInfo": {
"signingTime": "2026-10-16T14:58:44+03:00",
"fullName": "Anna Test Jónsdóttir",
"idpName": "audkenni-app",
"nin": "0101309999",
"uniqueId": "0101309999",
"firstName": "Anna Test",
"lastName": "Jónsdóttir",
"extra": {
"client-ip": "203.0.113.42",
"user-agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 Chrome/148.0.0.0 Safari/537.36"
}
},
"seals": []
}
}
Use resultDocumentId to retrieve the signed PDF. For multiple documents, match each result to its input using originalDocumentId rather than array order.
Limitations
- Only PDF documents are supported.
- Signer identity prefill is not supported.
- Date of birth (
dateOfBirth) is not available.
Test accounts
You can test Auðkenni signing in the sandbox with a test identity activated in the Auðkenni test app, which Auðkenni provides.
For the test environment, test certificates and access to the test app, see the Auðkenni environments page.