Skip to main content
GET
/
v1
/
surplus-lines-filings
cURL
curl --request GET \
  --url https://public.api.live.turrisfi.com/v1/surplus-lines-filings
{
  "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"
}
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

ParameterTypeRequiredDescription
statusstringNoFilter by filing status: not started, in progress, ready to file, filed, completed, on hold, or canceled
stateCodestringNoFilter by 2-letter US state or territory code (e.g., CA)
policyNumberstringNoFilter by exact policy number
externalReferencestringNoFilter 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

FieldTypeDescription
_idstringUnique filing identifier
externalReferencestring?The external reference you assigned to the filing (null if not set)
policyNumberstringPolicy number the filing is for
stateCodestringUS state or territory code where the filing is made
policyTransactionTypestringTransaction type: bind, endorsement, renewal, or cancellation
statusstringFiling status: not started, in progress, ready to file, filed, completed, on hold, or canceled
actionRequiredbooleantrue when a public checklist escalation is waiting on your input
effectiveDatestring?Policy effective date (ISO 8601), null if not set
updatedAtstringISO 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
​
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"