Skip to main content
GET
List surplus lines states
Returns every state Turris keeps surplus lines requirements for, ordered by state code. Pass limit=100 to get all of them in one call.

Polling for changes

Each row carries updatedAt. It moves whenever Turris changes anything about the state, including details no response shows, so treat it as a signal rather than a description of the change. When it moves, fetch Get State Requirements and Get State Taxes and Fees for that state again.

Query Parameters

Response Shape

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

Response Fields

Access

These endpoints need the Surplus-Lines Filing product feature in addition to API access. Without it every request to these endpoints returns 403.

Limits

Each surplus lines states endpoint allows 120 requests per 60 seconds per organization. Past that it returns 429 with a Retry-After header. See Rate Limiting.

Error Scenarios

Bad Request (400)

Returned when page or limit is out of range.

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)

Returned when the limit above is exceeded.

Authorizations

Authorization
string
header
required

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

Query Parameters

page
integer
default:1

1-based page number

Required range: x >= 1
Example:

1

limit
integer
default:50

Page size (max 100)

Required range: 1 <= x <= 100
Example:

50

Response

A page of surplus lines states

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"