Skip to main content
POST
Create a new sajn ID verification

Authorizations

Authorization
string
header
required

OAuth 2.0 access token for a connected application. Limited to the scopes granted at consent.

Headers

authorization
string
required

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.

Maximum string length: 255

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

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

Phone number (required for SMS channel)

reference
string

Optional reference/external ID for tracking

contactId
string

Optional contact ID to link this verification to

expiresAt
any

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

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,
IN_APP
status
enum<string>
required

Current verification status

Available options:
CREATED,
SENT,
OPENED,
VERIFIED,
FAILED,
EXPIRED,
CANCELED
locale
string
required

Locale for messages

expiresAt
any
required

When the identity check (and its link) 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

verifiedAt
any | null

When the verification was completed

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)