Skip to main content
Webhooks belong to the Carrier & MGA API. This event fires about an agency you appoint, and only a credential on that surface (carrier, MGA or wholesaler) can subscribe to it.

Overview

The DOCUMENT_EXTRACTION_COMPLETED webhook is triggered when Turris finishes reading an agency’s E&O, cyber, W-9 or crime/fidelity document, whether it succeeded or failed. Subscribe to it instead of polling for the extraction status. Webhook type: DOCUMENT_EXTRACTION_COMPLETED

Triggers

This webhook fires when:
  • Extraction on a document you uploaded (for example with Upload a Document) finishes
  • Extraction on a document the agency uploaded itself, and that you can see, finishes
  • A W-9’s status changes after the agency corrects its details in Turris
It fires once per outcome. If a document is read again and finishes again, you receive another delivery.

Who receives it

You receive it when the extracted version is the one you currently see for that agency: the same version Get E&O/Cyber Compliance would return to you. A document the agency shares with several carriers notifies each of them. A version you uploaded yourself notifies only you. If you have since uploaded a newer version, you are not notified about the older one.
This webhook is sent immediately. No debouncing is applied, since each extraction is a discrete event.

Payload Example

Field Reference

Payload Fields

Reading the extracted data

The payload tells you that extraction finished, not what it found. After a delivery:
  • E&O and cyber: call Get E&O/Cyber Compliance with downstreamEntityAssociationId to read the policy details.
  • W-9 and crime/fidelity: the extracted details are not available through the API yet. The status in the payload tells you whether the document was read, and you can download the file with fileDocumentId.