sign

Create an envelope (quote)

Upload a PDF (document_url or document_base64, max 10 MB, 100 pages) with a title and 1 to 5 signers (name + email), or self_sign with signer_name for the human to sign it themselves, and optional fields placed by page and x/y fractions (omit fields to append a signature page); stores a DRAFT and returns a price quote (quote.total_cents) whose quote_id send_envelope takes -- free, sends nothing and charges nothing. Not available for wills, codicils or testamentary trusts; adoption, divorce or other family-law matters; court orders or court documents; utility shut-off, eviction, foreclosure, repossession or insurance-cancellation notices; product-recall notices; hazardous-materials papers; negotiable instruments; or anything that must be notarized or witnessed.

post/v1/envelopes

Request

  • Base URL: https://api.noerrands.com/c/sign
  • URL: https://api.noerrands.com/c/sign/v1/envelopes
  • Auth: HTTP bearer

Request body

titlestring required

What the document is, shown to every signer, e.g. "Lease for 12 Oak St".

document_urlstring uri

HTTPS URL of the PDF. Exactly one of document_url or document_base64. At most 10 MB and 100 pages, not password-protected.

document_base64string

The PDF itself, base64 (a data:application/pdf;base64, prefix is fine). Exactly one of document_url or document_base64.

self_signboolean

True when the human is signing this themselves (for example a form you filled in). Give signer_name, not signers.

signer_namestring

self_sign only: the human's full name. Required there.

signer_emailstring email

self_sign only: the human's email for the certificate. Defaults to the account email.

messagestring

Optional note shown to signers above the document.

expires_in_daysinteger

Days the signing links stay open after sending. Default 30.

retention_days30 | 90 | 365 | 1095

Days we keep the finished document after completion before deleting it: 30, 90, 365 (default) or 1095. The human can delete it any time sooner.

Response

Success.

envelope_idstring required
status'draft' required
titlestring required
mode'request' | 'self' required
pagesinteger required
placement'fields' | 'signature_page' required
document_sha256string required
expires_in_daysinteger required
retention_daysinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.