Skip to main content
GET
Get a state's surplus lines requirements
Returns a state’s filing deadline and the documents a surplus lines filing in that state needs from you, grouped by category and sorted by order.

Matching a filing’s checklist

sourceTaskId is the same value a filing opened in this state carries as sourceTaskId on the matching checklist item, and sourceCategoryId the same as the item’s sourceCategoryId. Use them to prepare documents before you open a filing and to recognise the items on it afterwards. Both ids stay the same when Turris edits the state’s requirements. sourceCategoryId is repeated on every item, so categories.flatMap((category) => category.items) keeps it.

Blank forms

Where the state provides a form, the requirement lists it in templateFiles as metadata: name, type, size, label and upload time. Get a short-lived link for one with Get a Download URL for a State Template File, passing its id as templateFileId.

What is not listed

Items Turris keeps internal never appear, nor do their files. A state whose every item is internal returns categories: [].

Response Shape

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

Response Fields

Error Scenarios

Bad Request (400)

Returned when stateCode is not a US state or territory code.

State Not Found (404)

Returned for a state Turris keeps no surplus lines requirements for.

Unauthorized (401)

Missing or invalid authentication token. See Authentication.

Forbidden (403)

Your organization is not entitled to the API, or does not have the Surplus-Lines Filing feature.

Too Many Requests (429)

More than 120 requests in 60 seconds from your organization. See Rate Limiting.

Authorizations

Authorization
string
header
required

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

Path Parameters

stateCode
enum<string>
required

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:

"TX"

Response

The state's surplus lines requirements

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"