{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/docs/ai/document-ai/signatures/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Signatures

\n

Document AI provides two complementary ways to work with signatures:

\n
    \n
  1. \nDetected signature regions\n identify marks and their locations on processed pages.\n
    2. \n
  2. \nStructured signature results\n describe the business role and status of expected signatures when the selected extraction configuration includes the \nsignature\n schema.\n
    3. \n
\n

Neither capability verifies a signer's identity or determines the legal validity of a signature.

\n

Detected signature regions

\n

Completed documents can expose detected signatures through the investigation endpoints. Each item identifies its page, result, and normalized location.

\n\n
\n
\n curlpython\n
\n
\n
\n
/signatures" \\\\\n -H "Authorization: Token "`, `56698429049660555000`)\"\n >\n
Copy
\n
Copied
\n
\n 
curl \\\n  "https://sandbox-api.shipwell.com/document-store/documents/<document-id>/signatures" \\\n  -H "Authorization: Token <user-token>"
\n
\n
/signatures",\n headers={"Authorization": "Token "},\n timeout=30,\n)\nresponse.raise_for_status()\nsignatures = response.json()`, `74260283703618760000`)\"\n >\n
Copy
\n
Copied
\n
\n 
import requests\n\nresponse = requests.get(\n    \"https://sandbox-api.shipwell.com/document-store/documents/<document-id>/signatures\",\n    headers={\"Authorization\": \"Token <user-token>\"},\n    timeout=30,\n)\nresponse.raise_for_status()\nsignatures = response.json()
\n
\n
\n \n

Each item includes a page_number, result_id, and normalized geometry.

\n

Use optional run_id or result_id query parameters to inspect one processing attempt or split result.

\n\n

Structured signature results

\n

All platform-managed configurations include a signature extraction schema. It can return one entry for each expected execution role.

\n

A structured signature value can include:

\n\n

The selected configuration defines which document context is considered. For example, Shipment Operations emphasizes transportation execution roles, while Carrier Compliance covers agreements and compliance forms.

\n

Which signature surface should I use?

\n

Use detected regions when you need to:

\n\n

Use structured results when you need to:

\n\n

For high-impact workflows, show the structured result together with its source region.

\n

Proof-of-delivery workflow

\n
    \n
  1. \nProcess a proof of delivery with Shipment Operations or Universal Logistics.\n
    2. \n
  2. \nWait for the run to reach \ncompleted\n.\n
    3. \n
  3. \nFind \nsignature\n entries in the result's \nschemas\n.\n
    4. \n
  4. \nRetrieve \n/signatures\n or the relevant page to display the evidence.\n
    5. \n
  5. \nRoute absent or unclear expected signatures for human review.\n
    6. \n
\n

Important limitations

\n","headings":[{"value":"Signatures","depth":1},{"value":"Detected signature regions","depth":2},{"value":"Structured signature results","depth":2},{"value":"Which signature surface should I use?","depth":2},{"value":"Proof-of-delivery workflow","depth":2},{"value":"Important limitations","depth":2}]},"contentItem":{"data":{"lastModified":"2026-07-17T16:00:10.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":true,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"2ae0e1b5-2b43-5183-a61f-2a2057272925__redocly content/docs/ai/document-ai/signatures/","seo":{"title":"Signatures","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"docs/ai/document-ai/signatures.md","pageBaseUrl":"/docs/ai/document-ai/signatures","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Signatures","id":"signatures"},{"depth":2,"value":"Detected signature regions","id":"detected-signature-regions"},{"depth":2,"value":"Structured signature results","id":"structured-signature-results"},{"depth":2,"value":"Which signature surface should I use?","id":"which-signature-surface-should-i-use"},{"depth":2,"value":"Proof-of-delivery workflow","id":"proof-of-delivery-workflow"},{"depth":2,"value":"Important limitations","id":"important-limitations"}]},"data":{"title":"Signatures"},"catalogInfo":null,"link":"/docs/ai/document-ai/signatures/","sidebarName":"developerPortal","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}