Activity events
Every entry type in a document's activity log, the audit trail behind the signing journal
sajn records everything that happens to a document in its activity log: who sent it, who opened it, how each party verified their identity, and when the PDF was sealed. The log is the source of the signing journal and the timestamps on the signing certificate.
Activity events aren't webhook events. Webhooks notify your server about a smaller set of changes as they happen, with dotted lowercase types such as document.party.signed. The activity log is the complete record, which you read when you need it, and its types are uppercase, such as DOCUMENT_SIGNED.
Read the activity log
To read a document's log, call GET /documents/{id}/activity. It needs the READ_DOCUMENT_AUDIT_LOG workspace permission. The response is a page of events, newest first:
{
"data": [
{
"id": "cm4k2x9p90011abcd4567klmn",
"createdAt": "2026-10-01T09:41:05.000Z",
"type": "DOCUMENT_SIGNED",
"data": {},
"name": "Kai Berg",
"email": "kai@example.com"
}
],
"hasMore": true,
"nextCursor": "eyJjIjoiY3JlYXRlZEF0IiwidiI6IjIwMjYtMTAtMDFUMDk6NDE6MDUuMDAwWiIsImlkIjoiY200azJ4OXA5MDAxMWFiY2Q0NTY3a2xtbiJ9"
}To read the whole log, request the next page with cursor set to nextCursor until hasMore is false. For more information, see Pagination.
| Field | Description |
|---|---|
id | The event ID. |
createdAt | When the event happened. |
type | The event type, from the following tables. |
data | Event-specific details. Its shape depends on type. |
name, email | The person who caused the event, when known. |
The response leaves out IP addresses, user agents, and request metadata. Treat type as an open list: sajn can add new types without a new API version.
Delivery
| Type | Description |
|---|---|
EMAIL_SENT | An invitation email was sent to a party. |
SMS_SENT | An invitation SMS was sent to a party. |
REMINDER_SENT | A reminder was sent to a party. |
REMINDERS_STOPPED | Automatic reminders stopped. |
DELIVERY_DELIVERED | An email was delivered. |
DELIVERY_BOUNCED | An email bounced. |
DELIVERY_FAILED | An email couldn't be delivered. |
DELIVERY_COMPLAINED | The recipient marked an email as spam. |
DELIVERY_SUPPRESSED | An email wasn't sent, because delivery to the address is suppressed. |
Parties
The party event types keep their original names, from before the API called participants parties.
| Type | Description |
|---|---|
SIGNER_CREATED | A party was added. |
SIGNER_UPDATED | A party's details changed. |
SIGNER_DELETED | A party was removed. |
SIGNING_URL_ACCESSED | A party's signing URL was fetched. |
SIGNER_VARIABLES_SUBMITTED | A party submitted the values they fill in before signing. |
SIGNER_ATTACHMENT_UPLOADED | A party uploaded an attachment. |
Document lifecycle
| Type | Description |
|---|---|
DOCUMENT_CREATED | The document was created. |
DOCUMENT_SENT | The document was sent for signing. |
DOCUMENT_OPENED | A party opened the document. |
DOCUMENT_READ | A party read the whole document. |
DOCUMENT_VIEWED | Someone viewed the document. |
DOCUMENT_SIGNED | A party signed. |
DOCUMENT_SIGNATURE_MARK_CAPTURED | A party drew a signature or initials mark. |
DOCUMENT_REJECTED | A party rejected the document. |
DOCUMENT_COMPLETED | Every required party signed, and the document completed. |
DOCUMENT_FORCE_COMPLETED | The document was completed manually. |
DOCUMENT_WITHDRAWN | The document was withdrawn and returned to draft. |
DOCUMENT_CANCELLED | The document was cancelled. |
DOCUMENT_RESET | The document was reset to draft. |
DOCUMENT_RECREATED | The document was recreated. |
DOCUMENT_EXPIRATION_EXTENDED | The expiration date of a sent document moved. |
DOCUMENT_DELETED | The document was moved to the trash. |
DOCUMENT_RESTORED | The document was restored from the trash. |
DOCUMENT_ARCHIVED | The document was archived. |
DOCUMENT_UNARCHIVED | The document was unarchived. |
DOCUMENT_DOWNLOADED | A file of the document was downloaded. |
DOCUMENT_API_ACCESS | The document was read through the API. |
DOCUMENT_UNAUTHORIZED_ACCESS | Someone tried to open the document without access. |
Approval
| Type | Description |
|---|---|
DOCUMENT_APPROVAL_REQUESTED | The document was submitted for internal approval. |
DOCUMENT_APPROVAL_APPROVED | The approver approved the document. |
DOCUMENT_APPROVAL_REJECTED | The approver rejected the document. |
Document changes
| Type | Description |
|---|---|
DOCUMENT_TITLE_UPDATED | The name changed. |
DOCUMENT_META_UPDATED | The settings in documentMeta changed. |
DOCUMENT_EXTERNAL_ID_UPDATED | The externalId changed. |
DOCUMENT_EXPIRATION_DATE_UPDATED | The expiration date changed. |
DOCUMENT_SIGNING_ORDER_UPDATED | The signing order changed. |
DOCUMENT_VALUE_UPDATED | The value changed. |
DOCUMENT_RESPONSIBLE_USER_UPDATED | The responsible user changed. |
DOCUMENT_PREFERRED_LANGUAGE_UPDATED | The language changed. |
DOCUMENT_VISIBILITY_UPDATED | The visibility changed. |
DOCUMENT_CUSTOM_FIELD_VIEWED | Someone viewed a secured custom field value. |
DOCUMENT_LINKED | The document was linked to another document. |
DOCUMENT_UNLINKED | A link to another document was removed. |
Sealing and timestamps
| Type | Description |
|---|---|
DOCUMENT_SEALED | The document was sealed. |
DOCUMENT_SEALED_PDF_CREATED | The sealed PDF was generated. |
DOCUMENT_SEALED_PDF_PADES_SIGNATURES_APPLIED | The PAdES signatures were applied to the sealed PDF. |
DOCUMENT_SEALED_PDF_PADES_FAILED | Applying the PAdES signatures failed. |
DOCUMENT_TIMESTAMP_REQUESTED | A trusted timestamp was requested. |
DOCUMENT_TIMESTAMP_ADDED | A trusted timestamp was added. |
DOCUMENT_TIMESTAMP_FAILED | A trusted timestamp couldn't be added. |
DOCUMENT_TIMESTAMP_SKIPPED | A trusted timestamp was skipped. |
DOCUMENT_RFC3161_DETECTED | An RFC 3161 timestamp was found in the PDF. |
Swedish BankID
| Type | Description |
|---|---|
BANKID_AUTH_INITIATED | A BankID identification started. |
BANKID_AUTH_COMPLETED | A BankID identification completed. |
BANKID_AUTH_FAILED | A BankID identification failed. |
BANKID_NAME_VERIFICATION_MATCH | The BankID name matched the party's name. |
BANKID_NAME_VERIFICATION_MISMATCH | The BankID name didn't match the party's name. |
BANKID_SSN_VERIFICATION_MATCH | The BankID personal number matched the party's nationalId. |
BANKID_SSN_VERIFICATION_MISMATCH | The BankID personal number didn't match the party's nationalId. |
BANKID_SSN_VERIFICATION_BLOCKED | Signing was refused, because the personal number didn't match and the workspace requires a match. |
Other eIDs
| Type | Description |
|---|---|
EID_AUTH_INITIATED | An eID identification started. |
EID_AUTH_COMPLETED | An eID identification completed. |
EID_AUTH_FAILED | An eID identification failed. |
EID_IDENTITY_MATCH | The eID identity matched the party. |
EID_IDENTITY_MISMATCH | The eID identity didn't match the party. |
EID_IDENTITY_BLOCKED | Signing was refused, because the identity didn't match and the workspace requires a match. |
Verification before opening
| Type | Description |
|---|---|
SMS_VERIFICATION_SENT | An SMS code was sent. |
SMS_VERIFICATION_RESENT | An SMS code was sent again. |
SMS_VERIFICATION_COMPLETED | The party entered the right SMS code. |
SMS_VERIFICATION_FAILED | The party entered a wrong SMS code. |
EMAIL_VERIFICATION_SENT | An email code was sent. |
EMAIL_VERIFICATION_RESENT | An email code was sent again. |
EMAIL_VERIFICATION_COMPLETED | The party entered the right email code. |
EMAIL_VERIFICATION_FAILED | The party entered a wrong email code. |
PIN_VERIFICATION_COMPLETED | The party entered the right PIN. |
PIN_VERIFICATION_FAILED | The party entered a wrong PIN. |
Click to sign
| Type | Description |
|---|---|
CLICK_TO_SIGN_INITIATED | The party clicked to sign. |
CLICK_TO_SIGN_CONFIRMED | The party confirmed the signature. |
CLICK_TO_SIGN_TIMEOUT | The party didn't confirm in time. |
Delegation
| Type | Description |
|---|---|
DELEGATION_CREATED | A party delegated signing to someone else. |
DELEGATION_ACCEPTED | The delegate accepted. |
DELEGATION_DECLINED | The delegate declined. |
DELEGATION_REVOKED | The delegation was revoked. |
DELEGATION_EXPIRED | The delegation expired. |
DELEGATION_COMPLETED | The delegate signed. |
Was this page helpful?
Last updated on