Skip to main content
Solved

Inquiry: Polling Violation

  • November 4, 2025
  • 1 reply
  • 34 views

Hi DocuSign Community,

I need some guidance on the correct architectural pattern for checking envelope status without violating API rules.

 

Context: I’m a developer using the docusign eSignature product. I have an envelope that requires signatures from two separate recipients. I need to trigger a specific operation in my application, but after both recipients have successfully signed and the envelope is complete, and when only either one of the recipient has signed the contract. 

 

Problem: My initial thought was to call the GET /envelopes/{envelopeId} endpoint to check the recipients' status every time one of them signs. However, these two signatures could easily happen within minutes of each other. This would mean I'd be making multiple GET calls to the same envelope ID in less than the 15-minute window, which I believe violates the API polling rules. My application is already live, and I want to ensure I remain compliant. I have also read this, where there isn’t a specific guideline or checks that is in place to determine whether I have violated the policy.

 

Asks: Does my proposed method (calling GET /envelopes to check status after a recipient signs) count as prohibited polling?

 

Thank you

Best answer by JohnSantos

@Quoc Do 

No, your approach wouldn’t automatically violate DocuSign’s API rules, but it is considered polling and DocuSign explicitly discourages it.

I recommend you look into using DocuSign’s Connect service.  

  • You register a Connect configuration (or eventNotification on your envelope request).
  • DocuSign sends HTTPS POST notifications to your endpoint whenever envelope or recipient status changes.
  • Those notifications contain the status (Completed, Sent, Delivered, Signed, etc.) and recipient info.

1 reply

JohnSantos
Guru
Forum|alt.badge.img+19
  • Guru
  • 1076 replies
  • Answer
  • November 4, 2025

@Quoc Do 

No, your approach wouldn’t automatically violate DocuSign’s API rules, but it is considered polling and DocuSign explicitly discourages it.

I recommend you look into using DocuSign’s Connect service.  

  • You register a Connect configuration (or eventNotification on your envelope request).
  • DocuSign sends HTTPS POST notifications to your endpoint whenever envelope or recipient status changes.
  • Those notifications contain the status (Completed, Sent, Delivered, Signed, etc.) and recipient info.