List signature envelopes with optional status filter and pagination. Returns envelope summaries including signers, documents, and blockchain anchoring status.

Get full details of a specific envelope including all signers, documents, status, security level, and blockchain anchoring info.

Create and send a new envelope for signing. Requires a name, at least one signer, and at least one document (pass document IDs from upload_document, or pass a templateId to create from a template). Signers are notified via their chosen delivery method. Use securityLevel to match the legal weight required: STANDARD for routine/internal approvals; VERIFIED (adds SMS/email OTP) for employment, vendor, or healthcare consent; CERTIFIED (adds WebAuthn biometric + device binding) for real estate, high-value, or regulatory signings.

List available document templates. Templates provide pre-configured documents with defined signer roles and form-field placement.

Upload a local file to SignaTrust and return a document ID suitable for passing to create_envelope. Reads the file from disk, requests a pre-signed S3 upload URL, streams the bytes, and returns metadata. Supported: PDF (recommended), DOCX, images. Max size is enforced by your plan's limits.

Run AI contract analysis (Google Gemini) on a completed envelope's document. Returns a structured report covering risk assessment, flagged clauses, and overall sentiment (SAFE / CAUTION / RISKY). Plan-gated: free accounts receive a 403; upgrade to Pro Lite or above to use this. Surface the 403 message to the user rather than retrying.

Void (cancel) an in-progress envelope. The envelope's status becomes VOIDED, all signers receive a cancellation notice, and the void is recorded in the audit trail. Use this when the sender needs to cancel a contract that has already been sent to signers. Fails if the envelope is already COMPLETED or already VOIDED — use get_envelope first to check status. After voiding, the envelope can be deleted via the dashboard or DELETE /api/v1/envelopes/{id}.

Verify a completed envelope's Solana anchor. Returns the composite hash (SHA-256 binding the final PDF, signer metadata, and the hash-chained audit trail), the file hash, the Solana transaction ID, and an explorer URL. Because the composite hash is anchored to Solana, any modification to the document, signer records, or audit trail breaks the hash chain and fails verification. This is the proof that makes the envelope independently verifiable without SignaTrust.