Create a new sajn ID verification
2026-09, which is deprecated and stops working on October 1, 2027. To move your integration, see Upgrading to 2026-10.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) orphone(for SMS)
Optional Fields:
ssn- Swedish personal number for SSN-based verification (without SSN, name-based verification is used)reference- External reference ID for trackingnote- Internal note about this verificationcontactId- Link to existing contactlocale- Message locale (default: sv-SE)
Verification Methods:
- SSN-based: When
ssnis 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.
AuthorizationBearer <token>Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.
Idempotency-Key?stringMakes 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.
length <= 255Body
application/json- body
Create sajn ID verification request
fullName*stringFull name of the person to verify (required)
1 <= lengthssn?stringSwedish personal number (personnummer) for SSN-based verification
email?|Email address (required for EMAIL channel)
phone?|Phone number (required for SMS channel)
channel*stringDelivery channel: EMAIL or SMS (required)
"EMAIL""SMS"reference?stringOptional reference/external ID for tracking
contactId?stringOptional contact ID to link this verification to
locale*stringLocale for verification messages (default: sv-SE)
"sv-SE"expiresAt?unknownWhen the identity check (and its link) expires. Must be in the future. Defaults to 7 days from creation if omitted.
200
application/json- response
id*stringUnique sajn ID verification identifier
organizationId*stringOrganization ID
fullName*stringFull name of person being verified
email?|Email address (if using EMAIL channel)
phone?|Phone number (if using SMS channel)
channel*stringDelivery channel used
"EMAIL""SMS""IN_APP"status*stringCurrent verification status
"CREATED""SENT""OPENED""VERIFIED""FAILED""EXPIRED""CANCELED"reference?|Reference/external ID
locale*stringLocale for messages
expiresAt*unknownWhen the identity check (and its link) expires
verifiedAt?unknownWhen the verification was completed
createdAt*unknownWhen the verification was created
updatedAt*unknownWhen the verification was last updated
verificationUrl?stringVerification URL (only included when creating)
token?stringVerification 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)
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"}'{ "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?