What is difference in `lastModifiedDateTime` and `statusChangedDateTime` in docusign list envelope API?

Question

I have seen in the envelope status changes API in DocuSign, the lastModifiedDateTime is ahead of the statusChangesDateTime. I was expecting it must be same or in some case lastModifiedDateTime may greater than statusChangesDateTime when the enveloped is updated.

        "lastModifiedDateTime": "2021-10-19T13:54:08.4670000Z",
        "initialSentDateTime": "2021-10-19T13:54:09.0930000Z",
        "sentDateTime": "2021-10-19T14:28:09.9470000Z",
        "statusChangedDateTime": "2021-10-19T14:02:38.4800000Z",

I have to use the date in the listEnvelopeStatusChange API so that I will get the latest modified or status changed envelope always... Can I missing something here? Here is the request I am hitting for getting envelopes list:

GET https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes?count=10&from_date={statusChangedDateTime}&include=recipients&order_by=status_changed&order=asc&folder_types=normal,inbox,sentitems,draft&status=deleted,completed,created,declined,delivered,processing,sent,signed,timedout,voided&start_position=0

Inbar Gazit Inbar Gazit · Accepted Answer · 2021-10-19T19:27:32

lastModifiedDateTime - this is the last time (most recent) the envelope was changed. statusChangedDateTime - this the last time (most recent) the status of the envelope changed.

Not every change is a status change. So it's always possible that lastModifiedDateTime > statusChangedDateTime but never the other way around.

(they will be equal if the last change to the envelope was a status change, for example it was sent)

What is difference in `lastModifiedDateTime` and `statusChangedDateTime` in docusign list envelope API?

1 Answers