Surplus Lines Filings

cURL

curl --request GET \
  --url https://public.api.live.turrisfi.com/v2/upstream/surplus-lines-filings \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

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

import requests

url = "https://public.api.live.turrisfi.com/v2/upstream/surplus-lines-filings"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "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": {}
}

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

GET

upstream

surplus-lines-filings

cURL

curl --request GET \
  --url https://public.api.live.turrisfi.com/v2/upstream/surplus-lines-filings \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

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

import requests

url = "https://public.api.live.turrisfi.com/v2/upstream/surplus-lines-filings"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "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": {}
}

{
  "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 /v2/upstream/surplus-lines-filings?status=filed

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

# By your external reference
GET /v2/upstream/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.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

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

Carriers

Agencies You Appoint

Contract Container Templates

Agents

Contacts

Market Contacts

Licenses

Appointments

Compliance Data Subscriptions

Compliance Status

File Documents

Policy Ingestion

Policy Transactions

Diligent Effort

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)

Authorizations

Query Parameters

Response

​Query Parameters

​Filtering Examples

​Response Shape

​Response Fields

​Error Scenarios

​Bad Request (400)

​Unauthorized (401)

Authorizations

Query Parameters

Response

Query Parameters

Filtering Examples

Response Shape

Response Fields

Error Scenarios

Bad Request (400)

Unauthorized (401)