Skip to main content
GET
Get a surplus-lines filing
Returns one filing with its policy and tax detail, the escalation threads on the checklist items you can see, and any finished filing documents. Returns 404 when the filing was not submitted by your organization, which is the same response as an id that does not exist.

Escalations

An escalation is a thread on one checklist item. status tells you whether Turris is waiting on you, and each message carries an authorLabel of either Turris or Agency rather than a user identity. Checklist categories Turris keeps internal are excluded entirely, along with their reference fields. Replying to a thread happens in the Turris agency application; this API is read-only.

Completion artifacts

Finished documents, such as the accepted stamped filing, arrive as downloadUrl and viewUrl presigned links.
Those links are short-lived. Fetch the file when you receive the response rather than storing the URL, and never place it in a public page. An artifact whose link could not be signed is omitted rather than returned with a dead URL.

Taxes

totalTaxDue is null until Turris has computed the tax for the filing. grossPremium is always present.

Path Parameters

filingId
string
required

The filing id

Example:

"6650a1b2c3d4e5f6a7b8c9d0"

Response

Surplus-lines filing detail

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"