Submission Inbox and Worklist

List reinsurance workbooks with capture, mapping and check status, list the target structures they map into, and read the worklist of what needs a person.

Three read routes give the overview of a workspace's submissions. GET /v1/submissions is the inbox: one row per top-level workbook with its capture, mapping and check status. GET /v1/submissions/specs lists the target structures workbooks are mapped into. GET /v1/submissions/issues is the worklist: everything across the submissions that needs a person, in one list. All three need the read scope.

An inbox row's status is not_captured (the workbook was never read), captured (read, but no facts mapped under the requested structure), mapped (facts exist under it) or failed (the capture failed). The counts facts, metrics, checks_failed and checks_warned refer to the structure named by spec_id. cedent is the first fact's Cedent field, else the value a person stated for the whole submission; stated values appear in the inbox before they reach the facts, because the facts follow by a background re-map.

curl "https://api.talonic.com/v1/submissions?spec_id=5d1c0a52-0c1e-4b64-9d2e-7a3c4f1e9b10&q=utica&limit=20" \
  -H "Authorization: Bearer $TALONIC_API_KEY"

{
  "data": {
    "total": 1,
    "submissions": [
      {
        "document_id": "0b9a41de-6a9e-4f6c-8f42-1d7f2a3c5e60",
        "filename": "utica-first-2024.xlsx",
        "cedent": "Utica First",
        "captured_at": "2026-10-02T09:14:31.000Z",
        "status": "mapped",
        "tables": 12,
        "values": 4180,
        "facts": 312,
        "metrics": 9,
        "checks_failed": 2,
        "checks_warned": 5,
        "unmapped_labels": 3,
        "embedded_files": 1,
        "stated": { "Cedent": "Utica First" }
      }
    ]
  }
}

{
  "data": [
    { "kind": "check_failed", "document_id": "0b9a41de-6a9e-4f6c-8f42-1d7f2a3c5e60", "filename": "utica-first-2024.xlsx", "detail": { "failed": 2 } },
    { "kind": "labels_to_review", "document_id": null, "filename": null, "detail": { "spec_id": "5d1c0a52-0c1e-4b64-9d2e-7a3c4f1e9b10", "count": 3 } }
  ]
}

A labels_to_review item is global to the structure, not to a workbook, so its document_id is null. A missing_metric item names the metrics of the structure that a submission has no facts for, which makes it the first thing to check when a client format column stays empty in the export.