Status Updates - SANNOS Partner API

After submitting a document, poll for processing status. Endpoint: GET /v2/documents/{documentId}/status (Company Key)

Recommended: Poll every 3-5 minutes

  Partner ──GET /v2/documents/{documentId}/status──> API
         <── 200 OK { status, progressPercentage, ... }

  If status == "Processed" → Stop polling, fetch results
  If status == "Failed"    → Stop polling, handle error
  If status == "Pending" or "Processing" → Continue polling

Response (200) — Processing:

{
  "documentId": "01HXYZ...",
  "fileName": "policy.pdf",
  "status": "Processing",
  "progressPercentage": 60.0,
  "totalItems": 15,
  "completedItems": 9,
  "failedItems": 0,
  "resultSummary": null,
  "errorMessage": null,
  "processedAt": null,
  "createdAt": "2026-02-11T10:00:00Z"
}

When status = “Processed”, resultSummary is populated:

{
  "resultSummary": {
    "averageScore": 72.5,
    "passedCount": 10,
    "failedCount": 2,
    "warningCount": 3
  }
}

Status lifecycle:

Status	Meaning
`New`	Uploaded but not yet submitted
`Pending`	Queued for processing
`Processing`	Actively being analyzed
`Processed`	Complete — results available
`Failed`	Error occurred — see `errorMessage`

Webhooks: register a callback URL via PUT /v2/webhooks to receive document.processing.completed and document.processing.failed events instead of polling. See Webhooks.