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
TheDOCUMENT_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
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
downstreamEntityAssociationIdto 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.