Skip to main content
POST
/
api
/
v1
/
sajn-id
Create a new sajn ID verification
curl --request POST \
  --url https://app.sajn.se/api/v1/sajn-id \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '{
  "fullName": "<string>",
  "ssn": "<string>",
  "email": "jsmith@example.com",
  "phone": "<string>",
  "channel": "EMAIL",
  "reference": "<string>",
  "note": "<string>",
  "contactId": "<string>",
  "locale": "sv-SE",
  "sendImmediately": false
}'
{
  "id": "<string>",
  "organizationId": "<string>",
  "fullName": "<string>",
  "email": "<string>",
  "phone": "<string>",
  "channel": "EMAIL",
  "status": "CREATED",
  "reference": "<string>",
  "note": "<string>",
  "locale": "<string>",
  "tokenExpiresAt": "<any>",
  "usedAt": "<any>",
  "failureReason": "<string>",
  "createdAt": "<any>",
  "updatedAt": "<any>",
  "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": "<any>",
      "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 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)

sendImmediately
boolean
default:false
required

Whether to send the verification immediately after creation (default: false)

ssn
string

Swedish personal number (personnummer) for SSN-based verification

email

Email address (required for EMAIL channel)

phone

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

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

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 | null

Linked contact information

createdBy
object | null

User who created this verification

audits
object[]

Audit log entries for this verification

data
object | null

Verification data (e.g., BankID response)

I