Create a new sajn ID verification

Create a new identity verification request. Optionally send it immediately to the recipient.

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.

POST /api/v1/sajn-id

Create a new sajn ID verification

cURL

curl --request POST \
  --url https://app.sajn.se/api/v1/sajn-id \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "fullName": "<string>",
  "channel": "EMAIL",
  "locale": "sv-SE",
  "ssn": "<string>",
  "email": "[e-mail]",
  "phone": "<string>",
  "reference": "<string>",
  "note": "<string>",
  "contactId": "<string>"
}
'

200

{
  "id": "<string>",
  "organizationId": "<string>",
  "fullName": "<string>",
  "channel": "EMAIL",
  "status": "CREATED",
  "locale": "<string>",
  "tokenExpiresAt": "<unknown>",
  "createdAt": "<unknown>",
  "updatedAt": "<unknown>",
  "email": "<string>",
  "phone": "<string>",
  "reference": "<string>",
  "note": "<string>",
  "usedAt": "<unknown>",
  "failureReason": "<string>",
  "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": "<unknown>",
      "data": {},
      "name": "<string>",
      "email": "<string>",
      "ipAddress": "<string>",
      "userAgent": "<string>"
    }
  ],
  "data": {}
}

Headers

authorization · string · required

Bearer token for API authentication

Body

application/json

Body

Create sajn ID verification request

fullName · string · required

Full name of the person to verify (required)

Minimum string length: 1

channel · enum<string> · required

Delivery channel: EMAIL or SMS (required)

Available options: EMAIL, SMS

locale · string · default: sv-SE · required

Locale for verification messages (default: sv-SE)

ssn · string

Swedish personal number (personnummer) for SSN-based verification

email · string<email> enum<string>

Email address (required for EMAIL channel)

Pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$

phone · string enum<string>

Phone number (required for SMS channel)

reference · string

Optional reference/external ID for tracking

note · string

Internal note about this verification

contactId · string

Optional contact ID to link this verification to

Response

200

application/json

200

id · string · required

Unique sajn ID verification identifier

organizationId · string · required

Organization ID

fullName · string · required

Full name of person being verified

channel · enum<string> · required

Delivery channel used

Available options: EMAIL, SMS

status · enum<string> · required

Current verification status

Available options: CREATED, SENT, OPENED, VERIFIED, FAILED, EXPIRED, CANCELED

locale · string · required

Locale for messages

tokenExpiresAt · any · required

When the verification token expires

createdAt · any · required

When the verification was created

updatedAt · any · required

When the verification was last updated

email · string | null

Email address (if using EMAIL channel)

phone · string | null

Phone number (if using SMS channel)

reference · string | null

Reference/external ID

note · string | null

Internal note

usedAt · any | null

When the verification was completed

failureReason · string | null

Reason for failure (if status is FAILED)

verificationUrl · string

Verification URL (only included when creating)

token · string

Verification token (only included when creating, for sending)

contact · object

Linked contact information

Show child attributes

createdBy · object

User who created this verification

Show child attributes

audits · object[]

Audit log entries for this verification

Show child attributes

data · object

Verification data (e.g., BankID response)

Show child attributes