Document Status Guide
SignWell documents progress through several statuses. Each status signals a key lifecycle step—from drafting to signing, delivery issues, and archiving. Monitoring these statuses ensures you effectively guide documents to completion.
Here is a list of all the document statuses:
Status | Badge Color | Meaning |
---|---|---|
Draft | Dark Grey ![]() |
It was created, but it hasn't been sent or shared yet. |
Saved | Dark Grey ![]() |
Self-signing document. The user selected "I'm the only person signing" when preparing the document. |
Sent | Light Grey ![]() |
Emailed to recipient(s), awaiting action. |
Shared | Grey ![]() |
Sent via shareable signing link. |
Viewed | Blue ![]() |
Opened by the recipient, no action taken yet. |
In Progress | Blue ![]() |
At least one signer has started signing but not completed. |
Completed | Green ![]() |
All signers finished; the document is fully signed and finalized. |
Completed | Light Grey ![]() |
When the Mark as Signed feature is used, the Completed status will be light grey instead of green. |
Bounced | Red ![]() |
Email delivery failed. |
Declined | Red ![]() |
The recipient chose to decline signing the document. |
API Statuses
The API statuses align directly with API events, which you can subscribe to via webhooks. Whenever one of these events occurs, you'll receive a notification that matches the status transitions of the document in your account.
Status | API Event | Dashboard Display |
---|---|---|
1. Draft | document_created |
Draft |
2. Sent/Shared | document_sent |
Sent or Shared |
3. Viewed | document_viewed |
Viewed |
4. In Progress | document_in_progress |
In Progress |
5. Signed (per signer) | document_signed |
In Progress (until all have signed) |
6. Completed | document_completed |
Completed |
7. Expired | document_expired |
Expired |
8. Cancelled | document_canceled |
Cancelled |
9. Declined | document_declined |
Declined |
10. Bounced | document_bounced |
Bounced |
11. Error | document_error |
Error (for admin review) |
Would you still like some help? Reach out to us: support@signwell.com.