Surplus Lines Filing Status Change

Webhooks belong to the Carrier & MGA API. This event fires about one of your own filings, and only a credential on that surface (carrier, MGA or wholesaler) can subscribe to it.Surplus lines filings are visible on both surfaces, but the subscription is not. An agency can read its own filings through List Surplus-Lines Filings and poll them on a schedule, but it cannot subscribe to this event.

Overview

The SURPLUS_LINES_FILING_STATUS_CHANGE webhook is triggered when the status of a surplus lines filing changes — for example, when Turris moves a filing from In Progress to Filed. Webhook type: SURPLUS_LINES_FILING_STATUS_CHANGE

Triggers

This webhook fires when:

A Turris admin updates the status of a surplus lines filing (e.g., from in progress to filed, or from ready to file to completed)

This webhook is sent immediately — no debouncing is applied, since each status change is a discrete event requiring timely awareness.

Payload Example

{
  "webhookType": "SURPLUS_LINES_FILING_STATUS_CHANGE",
  "upstreamEntityId": "507f1f77bcf86cd799439010",
  "payload": {
    "filingId": "665f1a2b3c4d5e6f7a8b9c0d",
    "externalReference": "POL-2024-00123",
    "policyNumber": "SL-20240601-001",
    "stateCode": "TX",
    "status": "filed",
    "actionRequired": false
  }
}

Field Reference

Payload Fields

Field	Type	Description
`filingId`	string	The Turris ID of the surplus lines filing
`externalReference`	string \| null	Your external policy reference set when the filing was created, or `null` if none was provided
`policyNumber`	string	The policy number on the filing
`stateCode`	string	Two-letter US state or territory code (e.g., `TX`)
`status`	string	New filing status. One of: `not started`, `in progress`, `ready to file`, `filed`, `completed`, `on hold`, `canceled`
`actionRequired`	boolean	`true` when any checklist item escalation is currently waiting on customer input at the time the status change was recorded

Start Here

Shared Endpoints

Products

Agencies You Appoint

Contract Container Templates

Agents

Contacts

Market Contacts

Licenses

Appointments

Compliance Data Subscriptions

Compliance Status

File Documents

Policy Ingestion

Policy Transactions