PATCH /public/v1/documents/{id}/status

PandaDoc has eight document statuses, but you can manually set your document status to only four:

Document statuses

🚧 Pass a numeric code for the corresponding document status, for example, 2 for document.completed.

Find more details in [Editor 2.0] Manually change document status topic.

Current StatusTo Completed:To Expired:To Paid:To Declined:
DraftYESNOYESYES
ApprovedNONONONO
SentYESYESNOYES
ViewedYESYESNOYES
Completed (Auto)NONONOYES
Waithing for paymentNONOYESYES
PaidNONONONO
ExpiredYESNOYESYES
DeclinedYESNOYESNO

✅ - from document.voided to document.paid

❌ - from document.paid to document.voided

Servers

Path parameters

Name Type Required Description
id String Yes

Specify document ID.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
notify_recipients Boolean No

Send a notification email about the status change to all recipients.

note String No

Provide “private notes” regarding the manual status change.

status Integer Yes

Number code for the target document status. See notes for the codes corresponding to each status.

Valid values:

  • 11
  • 12
  • 2
  • 10

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.