> ## Documentation Index
> Fetch the complete documentation index at: https://docs.turrisfi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Surplus Lines Filing Status Change

> Webhook event triggered when a surplus lines filing status changes

## 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`)

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

## Payload Example

```json theme={null}
{
  "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 |