Skip to Content

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.

FieldDescription
idThe event ID.
createdAtWhen the event happened.
typeThe event type, from the following tables.
dataEvent-specific details. Its shape depends on type.
name, emailThe 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

TypeDescription
EMAIL_SENTAn invitation email was sent to a party.
SMS_SENTAn invitation SMS was sent to a party.
REMINDER_SENTA reminder was sent to a party.
REMINDERS_STOPPEDAutomatic reminders stopped.
DELIVERY_DELIVEREDAn email was delivered.
DELIVERY_BOUNCEDAn email bounced.
DELIVERY_FAILEDAn email couldn't be delivered.
DELIVERY_COMPLAINEDThe recipient marked an email as spam.
DELIVERY_SUPPRESSEDAn 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.

TypeDescription
SIGNER_CREATEDA party was added.
SIGNER_UPDATEDA party's details changed.
SIGNER_DELETEDA party was removed.
SIGNING_URL_ACCESSEDA party's signing URL was fetched.
SIGNER_VARIABLES_SUBMITTEDA party submitted the values they fill in before signing.
SIGNER_ATTACHMENT_UPLOADEDA party uploaded an attachment.

Document lifecycle

TypeDescription
DOCUMENT_CREATEDThe document was created.
DOCUMENT_SENTThe document was sent for signing.
DOCUMENT_OPENEDA party opened the document.
DOCUMENT_READA party read the whole document.
DOCUMENT_VIEWEDSomeone viewed the document.
DOCUMENT_SIGNEDA party signed.
DOCUMENT_SIGNATURE_MARK_CAPTUREDA party drew a signature or initials mark.
DOCUMENT_REJECTEDA party rejected the document.
DOCUMENT_COMPLETEDEvery required party signed, and the document completed.
DOCUMENT_FORCE_COMPLETEDThe document was completed manually.
DOCUMENT_WITHDRAWNThe document was withdrawn and returned to draft.
DOCUMENT_CANCELLEDThe document was cancelled.
DOCUMENT_RESETThe document was reset to draft.
DOCUMENT_RECREATEDThe document was recreated.
DOCUMENT_EXPIRATION_EXTENDEDThe expiration date of a sent document moved.
DOCUMENT_DELETEDThe document was moved to the trash.
DOCUMENT_RESTOREDThe document was restored from the trash.
DOCUMENT_ARCHIVEDThe document was archived.
DOCUMENT_UNARCHIVEDThe document was unarchived.
DOCUMENT_DOWNLOADEDA file of the document was downloaded.
DOCUMENT_API_ACCESSThe document was read through the API.
DOCUMENT_UNAUTHORIZED_ACCESSSomeone tried to open the document without access.

Approval

TypeDescription
DOCUMENT_APPROVAL_REQUESTEDThe document was submitted for internal approval.
DOCUMENT_APPROVAL_APPROVEDThe approver approved the document.
DOCUMENT_APPROVAL_REJECTEDThe approver rejected the document.

Document changes

TypeDescription
DOCUMENT_TITLE_UPDATEDThe name changed.
DOCUMENT_META_UPDATEDThe settings in documentMeta changed.
DOCUMENT_EXTERNAL_ID_UPDATEDThe externalId changed.
DOCUMENT_EXPIRATION_DATE_UPDATEDThe expiration date changed.
DOCUMENT_SIGNING_ORDER_UPDATEDThe signing order changed.
DOCUMENT_VALUE_UPDATEDThe value changed.
DOCUMENT_RESPONSIBLE_USER_UPDATEDThe responsible user changed.
DOCUMENT_PREFERRED_LANGUAGE_UPDATEDThe language changed.
DOCUMENT_VISIBILITY_UPDATEDThe visibility changed.
DOCUMENT_CUSTOM_FIELD_VIEWEDSomeone viewed a secured custom field value.
DOCUMENT_LINKEDThe document was linked to another document.
DOCUMENT_UNLINKEDA link to another document was removed.

Sealing and timestamps

TypeDescription
DOCUMENT_SEALEDThe document was sealed.
DOCUMENT_SEALED_PDF_CREATEDThe sealed PDF was generated.
DOCUMENT_SEALED_PDF_PADES_SIGNATURES_APPLIEDThe PAdES signatures were applied to the sealed PDF.
DOCUMENT_SEALED_PDF_PADES_FAILEDApplying the PAdES signatures failed.
DOCUMENT_TIMESTAMP_REQUESTEDA trusted timestamp was requested.
DOCUMENT_TIMESTAMP_ADDEDA trusted timestamp was added.
DOCUMENT_TIMESTAMP_FAILEDA trusted timestamp couldn't be added.
DOCUMENT_TIMESTAMP_SKIPPEDA trusted timestamp was skipped.
DOCUMENT_RFC3161_DETECTEDAn RFC 3161 timestamp was found in the PDF.

Swedish BankID

TypeDescription
BANKID_AUTH_INITIATEDA BankID identification started.
BANKID_AUTH_COMPLETEDA BankID identification completed.
BANKID_AUTH_FAILEDA BankID identification failed.
BANKID_NAME_VERIFICATION_MATCHThe BankID name matched the party's name.
BANKID_NAME_VERIFICATION_MISMATCHThe BankID name didn't match the party's name.
BANKID_SSN_VERIFICATION_MATCHThe BankID personal number matched the party's nationalId.
BANKID_SSN_VERIFICATION_MISMATCHThe BankID personal number didn't match the party's nationalId.
BANKID_SSN_VERIFICATION_BLOCKEDSigning was refused, because the personal number didn't match and the workspace requires a match.

Other eIDs

TypeDescription
EID_AUTH_INITIATEDAn eID identification started.
EID_AUTH_COMPLETEDAn eID identification completed.
EID_AUTH_FAILEDAn eID identification failed.
EID_IDENTITY_MATCHThe eID identity matched the party.
EID_IDENTITY_MISMATCHThe eID identity didn't match the party.
EID_IDENTITY_BLOCKEDSigning was refused, because the identity didn't match and the workspace requires a match.

Verification before opening

TypeDescription
SMS_VERIFICATION_SENTAn SMS code was sent.
SMS_VERIFICATION_RESENTAn SMS code was sent again.
SMS_VERIFICATION_COMPLETEDThe party entered the right SMS code.
SMS_VERIFICATION_FAILEDThe party entered a wrong SMS code.
EMAIL_VERIFICATION_SENTAn email code was sent.
EMAIL_VERIFICATION_RESENTAn email code was sent again.
EMAIL_VERIFICATION_COMPLETEDThe party entered the right email code.
EMAIL_VERIFICATION_FAILEDThe party entered a wrong email code.
PIN_VERIFICATION_COMPLETEDThe party entered the right PIN.
PIN_VERIFICATION_FAILEDThe party entered a wrong PIN.

Click to sign

TypeDescription
CLICK_TO_SIGN_INITIATEDThe party clicked to sign.
CLICK_TO_SIGN_CONFIRMEDThe party confirmed the signature.
CLICK_TO_SIGN_TIMEOUTThe party didn't confirm in time.

Delegation

TypeDescription
DELEGATION_CREATEDA party delegated signing to someone else.
DELEGATION_ACCEPTEDThe delegate accepted.
DELEGATION_DECLINEDThe delegate declined.
DELEGATION_REVOKEDThe delegation was revoked.
DELEGATION_EXPIREDThe delegation expired.
DELEGATION_COMPLETEDThe delegate signed.

Was this page helpful?

Last updated on