Skip to Content

Create a new sajn ID verification

You're viewing API version 2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.
POST
/api/v1/sajn-id

Create a new identity verification request and immediately send it to the recipient over the chosen channel.

Required Fields:

  • fullName - Full name of person to verify (required)
  • channel - Delivery channel: EMAIL or SMS (required)
  • Channel-specific: email (for EMAIL) or phone (for SMS)

Optional Fields:

  • ssn - Swedish personal number for SSN-based verification (without SSN, name-based verification is used)
  • reference - External reference ID for tracking
  • note - Internal note about this verification
  • contactId - Link to existing contact
  • locale - Message locale (default: sv-SE)

Verification Methods:

  • SSN-based: When ssn is provided, BankID verification validates both identity and SSN match
  • Name-based: Without ssn, BankID verifies identity and name match

Response: Returns verification details including token and verification URL (only on creation, never exposed later).

Billing: Creating a sajn ID verification counts toward your monthly sajn ID quota and is billed accordingly.

Authorization

headerAuthorizationBearer <token>

Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.

Header Parameters

authorization*string

Bearer token for API authentication

Idempotency-Key?string

Makes retries safe. A retry with the same key and the same request replays the stored response for 24 hours (header Idempotent-Replayed: true); the same key with a different request returns 400.

Lengthlength <= 255

Request Body

Body

application/json
  1. body

Create sajn ID verification request

fullName*string

Full name of the person to verify (required)

Length1 <= length
ssn?string

Swedish personal number (personnummer) for SSN-based verification

email?|

Email address (required for EMAIL channel)

phone?|

Phone number (required for SMS channel)

channel*string

Delivery channel: EMAIL or SMS (required)

Value in"EMAIL""SMS"
reference?string

Optional reference/external ID for tracking

contactId?string

Optional contact ID to link this verification to

locale*string

Locale for verification messages (default: sv-SE)

Default"sv-SE"
expiresAt?unknown

When the identity check (and its link) expires. Must be in the future. Defaults to 7 days from creation if omitted.

Response Body

200

application/json
  1. response
id*string

Unique sajn ID verification identifier

organizationId*string

Organization ID

fullName*string

Full name of person being verified

email?|

Email address (if using EMAIL channel)

phone?|

Phone number (if using SMS channel)

channel*string

Delivery channel used

Value in"EMAIL""SMS""IN_APP"
status*string

Current verification status

Value in"CREATED""SENT""OPENED""VERIFIED""FAILED""EXPIRED""CANCELED"
reference?|

Reference/external ID

locale*string

Locale for messages

expiresAt*unknown

When the identity check (and its link) expires

verifiedAt?unknown

When the verification was completed

createdAt*unknown

When the verification was created

updatedAt*unknown

When the verification was last updated

verificationUrl?string

Verification URL (only included when creating)

token?string

Verification token (only included when creating, for sending)

contact?|

Linked contact information

createdBy?|

User who created this verification

audits?array<>

Audit log entries for this verification

data?|

Verification data (e.g., BankID response)

Example Request
curl -X POST 'https://app.sajn.se/api/v1/sajn-id' \  -H 'authorization: string' \  -H 'Content-Type: application/json' \  -d '{  "fullName": "string",  "channel": "EMAIL",  "locale": "sv-SE"}'
Example Response
{  "id": "string",  "organizationId": "string",  "fullName": "string",  "email": "string",  "phone": "string",  "channel": "EMAIL",  "status": "CREATED",  "reference": "string",  "locale": "string",  "expiresAt": null,  "verifiedAt": null,  "createdAt": null,  "updatedAt": null,  "verificationUrl": "string",  "token": "string",  "contact": {    "id": "string",    "firstName": "string",    "lastName": "string",    "email": "string",    "phone": "string"  },  "createdBy": {    "id": "string",    "firstName": "string",    "lastName": "string",    "email": "string"  },  "audits": [    {      "id": "string",      "type": "string",      "createdAt": null,      "data": {        "property1": null,        "property2": null      },      "name": "string",      "email": "string",      "ipAddress": "string",      "userAgent": "string"    }  ],  "data": {    "property1": null,    "property2": null  }}

Was this page helpful?