Activity Log

Check the status of a document

Taktikals API returns a ProcessKey when a signing process is created. This key can be used to check the status of the process. (see ActivityLog bellow).

When all signees have signed, a web-hook request is sent containing the signed document.

Webhooks

How to check the status of the document?

There are two ways to get the ActivityLog

• GET /signing/activity/{ProcessKey} for a single item
• GET /signing/activity/user/ to get all activity for a given user (user is the one that starts the process)

Both endpoints support from and to dates to narrow down the search.

Example activity log for a SigningProcess with one signee that has signed.

[
  {
    processKey: "spa2f3e",
    activityLog: [
      {
        flowKey: "3fc7848d338a",
        processKey: "spa2f3e",
        status: "Created",
        description: "Signing process created. ProcessKey: spa2f3e.",
        fileName: "demo_skjal-drop-and-sign-small.pdf",
        createdAt: "2019-11-08T11:03:49.0700000Z",
        createdBy: "test@taktikal.is",
      },
      {
        flowKey: "3fc7848d338a",
        processKey: "spa2f3e",
        signeeKey: "si4265c7a3263e",
        status: "SigneeAdded",
        description:
          "Signee added. Processkey: spa2f3e. Signee key: si4265c7a3263e.",
        createdAt: "2019-11-08T11:03:49.1200000Z",
        createdBy: "Taktikal.Core",
      },
      {
        flowKey: "3fc7848d338a",
        processKey: "spa2f3e",
        signeeKey: "si4265c7a3263e",
        status: "SignupSent",
        description:
          "Signup sent. Processkey: spa2f3e. Signee: si4265c7a3263e. Delivery method : Sms ",
        createdAt: "2019-11-08T11:03:49.4070000Z",
        createdBy: "Taktikal.Core",
      },
      {
        flowKey: "3fc7848d338a",
        processKey: "spa2f3e",
        status: "Started",
        description: "Signing process started. ProcessKey: spa2f3e.",
        fileName: "demo_skjal-drop-and-sign-small.pdf",
        createdAt: "2019-11-08T11:03:49.4230000Z",
        createdBy: "test@taktikal.is",
      },
      {
        flowKey: "3fc7848d338a",
        processKey: "spa2f3e",
        signeeKey: "si4265c7a3263e",
        status: "SMS:DELIVERED",
        description: "SMS delviery status: DELIVERED.",
        createdAt: "2019-11-08T11:04:04.7030000Z",
        createdBy: "Taktikal.Core",
      },
      {
        flowKey: "3fc7848d338a",
        processKey: "spa2f3e",
        signeeKey: "si4265c7a3263e",
        status: "SigneeSigned",
        description:
          "Signee signed. ProcessKey: spa2f3e. Signee key: si4265c7a3263e",
        createdAt: "2019-11-08T11:06:01.5600000Z",
        createdBy: "Taktikal.Core",
      },
      {
        flowKey: "3fc7848d338a",
        processKey: "spa2f3e",
        signeeKey: "si4265c7a3263e",
        status: "Completed",
        description: "Signing completed. ProcessKey: spa2f3e.",
        createdAt: "2019-11-08T11:06:01.6070000Z",
        createdBy: "Taktikal.Core",
      },
      {
        flowKey: "3fc7848d338a",
        processKey: "spa2f3e",
        signeeKey: "si4265c7a3263e",
        status: "Confirmation:delivered",
        description:
          "Mailgun webhook. Event: delivered. To:testUser@taktikal.is. Sender:postmaster@mailgun.taktikal.is. Id:2NwQ3QahRtWZgK37JQ-I8Q. Severity: . Reason:",
        createdAt: "2019-11-08T11:06:04.9930000Z",
        createdBy: "Mailgun",
      },
      {
        flowKey: "3fc7848d338a",
        processKey: "spa2f3e",
        signeeKey: "si4265c7a3263e",
        status: "SalesPerson:delivered",
        description:
          "Mailgun webhook. Event: delivered. To:testUser@taktikal.is. Sender:postmaster@mailgun.taktikal.is. Id:0QEQpeM1SKuVgWZaIG0tfQ. Severity: . Reason:",
        createdAt: "2019-11-08T11:06:05.7500000Z",
        createdBy: "Mailgun",
      },
    ],
    signees: [
      {
        processKey: "spa2f3e",
        signeeKey: "si4265c7a3263e",
        ssn: "123456-7890",
        name: "Signee Number One",
        address: "Address 5",
        postalCode: "555",
        city: "Reykjavík",
        phone: "1234567",
        email: "signeeOne@taktikal.is",
        createdAt: "2019-11-08T11:03:49.1000000Z",
        createdBy: "Taktikal.Core",
        updatedAt: "2019-11-08T11:03:49.1000000Z",
      },
    ],
  },
];