List Surplus-Lines Filings

List surplus-lines filings

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

const options = {method: 'GET'};

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

{
  "data": {
    "items": [
      {
        "filingId": "6650a1b2c3d4e5f6a7b8c9d0",
        "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
        "policyNumber": "POL-123456",
        "stateCode": "PA",
        "policyTransactionType": "bind",
        "status": "not started",
        "actionRequired": false,
        "updatedAt": "2026-06-01T12:00:00.000Z",
        "externalReference": "REF-2026-0001",
        "effectiveDate": "2026-01-01T00:00:00.000Z"
      }
    ],
    "total": 137,
    "page": 1,
    "limit": 50,
    "totalPages": 3
  },
  "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": {}
}

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

GET

downstream

surplus-lines-filings

List surplus-lines filings

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

const options = {method: 'GET'};

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

{
  "data": {
    "items": [
      {
        "filingId": "6650a1b2c3d4e5f6a7b8c9d0",
        "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
        "policyNumber": "POL-123456",
        "stateCode": "PA",
        "policyTransactionType": "bind",
        "status": "not started",
        "actionRequired": false,
        "updatedAt": "2026-06-01T12:00:00.000Z",
        "externalReference": "REF-2026-0001",
        "effectiveDate": "2026-01-01T00:00:00.000Z"
      }
    ],
    "total": 137,
    "page": 1,
    "limit": 50,
    "totalPages": 3
  },
  "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": {}
}

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

Returns the surplus-lines filings your organization filed, covering your entity plus every branch beneath it, newest first.

Filings you filed, not filings about you

A filing records who submitted it and which agency the policy belongs to. This endpoint returns the ones your organization submitted. A filing a carrier made on your behalf is that carrier’s workflow, with its own escalation thread and its own internal checklist, so it is not returned here. If you expect a filing and do not see it, that is usually why. Every row carries downstreamEntityId, naming the entity that filed it, because the list spans your whole subtree.

Is Turris waiting on me

actionRequired is true when an escalation on a checklist item you can see is waiting for your input. Get a filing has the thread itself. The flag only ever reflects items visible to you. Turris keeps some checklist categories internal, and a flag you could never clear would read as a permanent to-do.

Access

This surface needs the Surplus-Lines Filing product feature in addition to API access. Without it every request here returns 403 while the rest of the agency API keeps working. If you expect access and see a 403, that feature is the thing to check.

Narrowing

status, stateCode, policyNumber and externalReference all match exactly. externalReference is your own reference as recorded on the filing, which makes it the field to use for reconciling against your own system. downstreamEntityId limits the list to one of your entities.

Query Parameters

page

number

default:1

1-based page number

Required range: x >= 1

Example:

1

limit

number

default:50

Page size (max 100)

Required range: 1 <= x <= 100

Example:

50

downstreamEntityId

string

Narrow the results to a single entity in your organization. Defaults to your whole subtree (your entity plus every branch beneath it). Returns 404 if the id is not in your subtree.

Example:

"6610b3d2c2e0a51b8c0d1f02"

status

enum<string>

Only filings in this status

Available options:

not started,

in progress,

ready to file,

filed,

completed,

on hold,

canceled

Example:

"not started"

stateCode

enum<string>

Only filings for this state

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:

"PA"

policyNumber

string

Exact policy number

Example:

"POL-123456"

externalReference

string

Your own reference recorded on the filing, matched exactly

Example:

"REF-2026-0001"

Response

A page of surplus-lines filings

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

Licensed Entities

Producers

Contacts

Licenses

Actions Required

Licensing Overview

Appointments

License Requests

Compliance Configurations

Markets

Corporate Registrations

Documents

Surplus Lines

Filings you filed, not filings about you

Is Turris waiting on me

Access

Narrowing

Query Parameters

Response

​Filings you filed, not filings about you

​Is Turris waiting on me

​Access

​Narrowing

Query Parameters

Response

Filings you filed, not filings about you

Is Turris waiting on me

Access

Narrowing