Surplus Lines Filings

cURL

curl --request GET \
  --url https://public.api.live.turrisfi.com/v1/surplus-lines-filings

const options = {method: 'GET'};

fetch('https://public.api.live.turrisfi.com/v1/surplus-lines-filings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "_id": "6650a1b2c3d4e5f6a7b8c9d0",
      "policyNumber": "POL-2025-001",
      "stateCode": "CA",
      "policyTransactionType": "bind",
      "status": "in progress",
      "actionRequired": true,
      "updatedAt": "2025-06-15T12:00:00.000Z",
      "externalReference": "EXT-REF-12345",
      "effectiveDate": "2025-01-01T00:00:00.000Z"
    }
  ],
  "requestId": "dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8",
  "timestamp": "2025-11-12T20:49:03.293Z"
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

GET

surplus-lines-filings

cURL

curl --request GET \
  --url https://public.api.live.turrisfi.com/v1/surplus-lines-filings

const options = {method: 'GET'};

fetch('https://public.api.live.turrisfi.com/v1/surplus-lines-filings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "_id": "6650a1b2c3d4e5f6a7b8c9d0",
      "policyNumber": "POL-2025-001",
      "stateCode": "CA",
      "policyTransactionType": "bind",
      "status": "in progress",
      "actionRequired": true,
      "updatedAt": "2025-06-15T12:00:00.000Z",
      "externalReference": "EXT-REF-12345",
      "effectiveDate": "2025-01-01T00:00:00.000Z"
    }
  ],
  "requestId": "dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8",
  "timestamp": "2025-11-12T20:49:03.293Z"
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

Returns the surplus lines filings owned by your upstream entity. Each item includes an actionRequired flag that is true when a public checklist escalation is currently waiting on your input. Results can be filtered by status, state, policy number, or the external reference you assigned.

Query Parameters

Parameter	Type	Required	Description
`status`	string	No	Filter by filing status: `not started`, `in progress`, `ready to file`, `filed`, `completed`, `on hold`, or `canceled`
`stateCode`	string	No	Filter by 2-letter US state or territory code (e.g., `CA`)
`policyNumber`	string	No	Filter by exact policy number
`externalReference`	string	No	Filter by the external reference identifier you assigned to the filing

Filtering Examples

# By status
GET /v1/surplus-lines-filings?status=filed

# By state
GET /v1/surplus-lines-filings?stateCode=CA

# By your external reference
GET /v1/surplus-lines-filings?externalReference=UNION-12345

Response Shape

All successful responses are wrapped in the standard response envelope. See Request/Response Conventions.

{
  "statusCode": 200,
  "data": [
    {
      "_id": "6650a1b2c3d4e5f6a7b8c9d0",
      "externalReference": "UNION-12345",
      "policyNumber": "POL-2025-001",
      "stateCode": "CA",
      "policyTransactionType": "bind",
      "status": "filed",
      "actionRequired": false,
      "effectiveDate": "2025-01-15T00:00:00.000Z",
      "updatedAt": "2025-01-16T10:31:45.000Z"
    }
  ],
  "timestamp": "2025-01-16T10:31:50.000Z"
}

Response Fields

Field	Type	Description
`_id`	string	Unique filing identifier
`externalReference`	string?	The external reference you assigned to the filing (null if not set)
`policyNumber`	string	Policy number the filing is for
`stateCode`	string	US state or territory code where the filing is made
`policyTransactionType`	string	Transaction type: `bind`, `endorsement`, `renewal`, or `cancellation`
`status`	string	Filing status: `not started`, `in progress`, `ready to file`, `filed`, `completed`, `on hold`, or `canceled`
`actionRequired`	boolean	`true` when a public checklist escalation is waiting on your input
`effectiveDate`	string?	Policy effective date (ISO 8601), null if not set
`updatedAt`	string	ISO 8601 timestamp of the last update

Filings with actionRequired: true need your attention. Fetch the filing detail to read the open escalation and its notes.

Error Scenarios

Bad Request (400)

Returned when a query parameter has an invalid value (e.g., an unsupported status).

{
  "statusCode": 400,
  "errorType": "validation_error",
  "errorMessage": ["Invalid value for status"],
  "requestId": "dev-abc123",
  "timestamp": "2025-01-16T10:30:00.000Z"
}

Unauthorized (401)

Missing or invalid authentication token. See Authentication.

Query Parameters

status

enum<string>

Filter by filing status

Available options:

not started,

in progress,

ready to file,

filed,

completed,

on hold,

canceled

Example:

"in progress"

stateCode

enum<string>

Filter by US state or territory code

Available options:

AL,

AK,

AZ,

AR,

CA,

CO,

CT,

DE,

FL,

GA,

HI,

ID,

IL,

IN,

IA,

KS,

KY,

LA,

ME,

MD,

MA,

MI,

MN,

MS,

MO,

MT,

NE,

NV,

NH,

NJ,

NM,

NY,

NC,

ND,

OH,

OK,

OR,

PA,

RI,

SC,

SD,

TN,

TX,

UT,

VT,

VA,

WA,

WV,

WI,

WY,

GU,

PR,

VI,

DC

Example:

"CA"

policyNumber

string

Filter by exact policy number

Example:

"POL-2025-001"

externalReference

string

Filter by external reference identifier assigned by the caller

Example:

"EXT-REF-12345"

Response

List of surplus-lines filings belonging to the authenticated upstream entity

data

object[]

required

Show child attributes

requestId

string

required

Unique request identifier

Example:

"dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8"

timestamp

string

required

Response timestamp

Example:

"2025-11-12T20:49:03.293Z"

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

Webhooks

E&O/Cyber Compliance

Regulatory Actions

Tools

Surplus Lines Filings

Query Parameters

Filtering Examples

Response Shape

Response Fields

Error Scenarios

Bad Request (400)

Unauthorized (401)

Query Parameters

Response

​Query Parameters

​Filtering Examples

​Response Shape

​Response Fields

​Error Scenarios

​Bad Request (400)

​Unauthorized (401)

Query Parameters

Response

Query Parameters

Filtering Examples

Response Shape

Response Fields

Error Scenarios

Bad Request (400)

Unauthorized (401)