Sign Title Documents
Initiate signature process for title documents
signers and documents_to_sign, or omit the body entirely to let the API build the request from the title entry. Auto-build requires signer contact_email values to already be present on the entry, usually via a prior PATCH /title/{id}.
redirect_url belongs in the request body, not the query string.
Signing URLs in the response
For Notarize/Proof-based organizations, the response includes per-signer signing URLs atsigners[].transaction_access_url. Each signer receives their own unique link to access the signing session.
transaction_access_url on the SignatureRequest object is not populated on the initial create response — it is only set after an explicit activate action on a DRAFT request. Always read signing URLs from signers[].transaction_access_url.
DocuSign-based requests do not include transaction_access_url — signing links are delivered directly to signers via email by DocuSign.
Internal signature actions for managing existing requests are not part of the partner-facing API surface.
Physical title return (title_collection)
For organizations enrolled in physical title collection, titles in states that require the original paper title to be shipped back to Cardinal Gray (e.g. Texas) additionally include a title_collection object in the sign response, alongside the signature-request fields. The same object is persisted on the entry and returned by subsequent GET /title/{id} reads.
title_collectionis additive and may be absent — for organizations, groups, states, or environments where physical title collection is not enabled, the response is unchanged. Existing clients must tolerate its absence.collection_idis stable: repeated sign actions, bumps, activations, and retries return the same collection rather than creating additional labels.tracking_numberis nullable: it isnulluntil a carrier shipment exists. Clients must handlenull.label_urlis the guaranteed printable-label fallback.instructionsare ready to display to the borrower as-is; render them rather than hardcoding your own copy.modedistinguishes sandbox (STUB) from production (LIVE) fulfillment; treat it as informational — the field contract is identical in both.qr_urlis optional and only present whenqr_verifiedistrue(a verified UPS mobile drop-off barcode). Clients must not assumeqr_urlexists or that an unverified QR is accepted at UPS.- Asset URLs are presigned and expire at
assets_expires_at— do not cache them indefinitely. - The bodyless sign request uses the ruleset-generated document path — no
signersordocuments_to_signare needed when contact emails are already on the entry.
STUB) responses, label_url renders a UPS sample label that is not valid postage, tracking_number is null, and qr_url is absent — the field contract is otherwise identical to production.Authorizations
API key or Clerk JWT supplied as Authorization: Bearer
Path Parameters
Unique identifier of the title entry
Body
Customization options for the signature request (e.g., in cases where you don't want to collect signatures from all titled owners).
List of specific people who should sign the documents. Each signer must include contact_email. If the body is omitted entirely, the API attempts to build signers from current owners/borrowers already stored on the entry.
1List of specific documents to be signed.
1Optional redirect URL or redirect descriptor used by the signature provider after signing.
Additional notification email for signature completion
Special instructions for the signer
Response
Signature request created successfully. For organizations enrolled in physical title collection, titles in states that require the original paper title to be returned (e.g. Texas) additionally include a title_collection object with return-shipping guidance.
Top-level transaction URL. Only populated after an explicit activate action on a DRAFT Notarize/Proof request. For the initial create response, look at each signer's transaction_access_url instead.
Additional notification email for signature completion
Provider-specific ID (NTRZ::id for Notarize, DSGN::id for DocuSign, DMNS::id for Documenso, PNDC::id for Pandadoc)
Type of signature required
WET_SIGN, WET_NOTARY, RON, E_SIGN, NONE Current status of the signature request
DRAFT, SENT, OPENED, COMPLETED, FAILED, EXPIRED When the request was created
Last status update
Signers on this request. In the response from POST /title/{id}/sign, each signer object includes a transaction_access_url field with the per-signer signing link (Notarize/Proof provider only).
S3 path to signing certification
S3 path to collected driver license ID
S3 path to full export consisting of sign cert, collected_dlid, and documents_to_sign
Any special instructions for the signer
Additional provider-specific metadata
Physical title return guidance. Present when the organization is enrolled in physical title collection and the title's signing state requires the original paper title to be shipped back to Cardinal Gray (e.g. Texas). Additive and may be absent — clients must tolerate its absence. Created at most once per title: repeated sign actions and retries return the same collection_id rather than creating a new collection.