Skip to main content
Creating a signature request is asynchronous, so check the status before you treat a request as sent. The status is returned when you create, get, or list a request.

​
Status values

  • converting: The file is converted to a .pdf after you send the request.
  • error_converting: Conversion to .pdf failed.
  • created: is_document_preparation_needed is true and no one has visited the prepare URL yet.
  • sent: The request was sent and no signer has interacted with it.
  • viewed: The first signer selected Review document in the email or opened the signing URL.
  • signed: All signers completed the request.
  • declined: A signer declined the request.
  • cancelled: The request was cancelled in the UI or API. For more information, see Cancel a Box Sign request.
  • expired: days_valid passed with incomplete signatures. For more information, see Request expiration.
An error status means you need a new sign request to retry.
Status diagram
The Box Sign request resource lists the complete set of values the status field can return, including states that this guide does not describe individually.

​
What you can do in each status

Last modified on September 18, 2026