Returns a single surplus lines filing by its unique identifier, including its escalation / action-required state and notes, and any completion artifacts (accepted/stamped filing, receipt, confirmation, tax/remittance proof) as short-lived presigned download links. The filing must belong to the authenticated upstream entity.
Path Parameters
Parameter
Type
Required
Description
filingId
string
Yes
Unique identifier of the filing (MongoDB ObjectId)
The filing carries the same summary fields as each item in List Surplus Lines Filings, plus the detail fields below.
Field
Type
Description
namedInsured
string
Name of the insured party
carrier
string
Insurance carrier name
carrierNaicCode
string
NAIC code of the carrier
grossPremium
number
Gross written premium
totalTaxDue
number?
Total surplus lines tax due, if a tax calculation exists (null otherwise)
escalations
array
Open and resolved escalations on public checklist items (see below)
completionArtifacts
array
Completion documents as presigned links (see below)
Escalation object
Field
Type
Description
checklistItemLabel
string
The checklist item the escalation is attached to
status
string
waiting turris input, waiting customer input, or resolved
openedAt
string?
ISO 8601 timestamp when the escalation was opened
resolvedAt
string?
ISO 8601 timestamp when it was resolved (null if open)
messages
array
Thread of messages, each with authorLabel (Turris or your agency), body, and createdAt
Completion artifact object
Field
Type
Description
type
string
accepted stamped, receipt, confirmation, or tax remittance proof
fileName
string
Original file name
uploadedAt
string
ISO 8601 timestamp when the artifact was attached
downloadUrl
string
Presigned download link (attachment; expires in ~1 hour)
viewUrl
string
Presigned inline-view link (expires in ~1 hour)
downloadUrl and viewUrl are short-lived presigned links. Fetch them fresh from this endpoint when you need to download an artifact rather than storing the URL.
Error Scenarios
Bad Request (400)
Returned when filingId is not a valid MongoDB ObjectId format.
{ "statusCode": 400, "errorType": "validation_error", "errorMessage": ["filingId must be a mongodb id"], "requestId": "dev-abc123", "timestamp": "2025-01-16T10:30:00.000Z"}
Filing Not Found (404)
Returned when filingId doesn’t exist or belongs to a different upstream entity.
Missing or invalid authentication token. See Authentication.
Authorizations
bearerrestricted-access-token
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
filingId
string
required
Unique identifier of the surplus-lines filing
Example:
"6650a1b2c3d4e5f6a7b8c9d0"
Response
Surplus-lines filing detail with escalations and completion artifacts
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"
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Turris Public API","description":"API documentation for the Turris Public API - programmatic access to compliance data for carrier and agency customers.","colors":{"primary":"#006cff","light":"#3389ff","dark":"#0a58c2"},"favicon":"https://mintcdn.com/turris/IfRLPQPmyFYwsFZX/favicon.png?fit=max\u0026auto=format\u0026n=IfRLPQPmyFYwsFZX\u0026q=85\u0026s=21d205b6e3e2b8abe477c8c7aed40817","api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","javascript","python"],"prefill":true}},"navbar":{"links":[{"href":"mailto:support@turrisfi.com","label":"Support"}],"primary":{"type":"button","label":"Web App (Live)","href":"https://www.app.live.turrisfi.com"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/turrisfi"},"links":[{"header":"Resources","items":[{"label":"Website","href":"https://www.turrisfi.com"},{"label":"Web App (Live)","href":"https://www.app.live.turrisfi.com"},{"label":"Web App (Sandbox)","href":"https://www.app.sandbox.turrisfi.com"},{"label":"Support Articles","href":"https://help.turrisfi.com"}]}]},"contextual":{"options":["mcp","cursor","vscode","copy","claude","chatgpt"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"turris","hasAudioNarration":false,"actualSubdomain":"turris","customDomains":["docs.turrisfi.com"],"gitSource":{"type":"github","owner":"turrisfi","repo":"compliance","deployBranch":"prod","contentDirectory":"apps/public-api/docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af746a0116b25a832ec7361","clientVersion":"0.0.4142","searchFilterCounts":[{"language":"default","tag":"Carrier \u0026 MGA API","count":146},{"language":"default","tag":"Agency API","count":56},{"language":"default","tag":"Surplus Lines","count":24},{"language":"default","tag":"Webhooks","count":23},{"language":"default","tag":"Webhook Events","count":18},{"language":"default","tag":"Policy Ingestion","count":14},{"language":"default","tag":"Agencies You Appoint","count":13},{"language":"default","tag":"Licenses","count":13},{"language":"default","tag":"Documentation","count":13},{"language":"default","tag":"Filings","count":12}],"searchSettings":{"isFiltersEnabled":true,"showContentSnippets":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@turrisfi.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"698de0cb27f1502f3265ea3b","deploymentId":"697d034dc7078c59853e519b","questionText":"How can I get my agencies' and agents' compliance status?","status":"active","generatedBy":"manual","createdAt":"2026-02-12T14:16:43.973Z","updatedAt":"2026-02-12T14:16:43.973Z","__v":0},{"_id":"698de0b027f1502f3265ea0c","deploymentId":"697d034dc7078c59853e519b","questionText":"How can I retrieve all my agencies and agents?","status":"active","generatedBy":"manual","createdAt":"2026-02-12T14:16:16.437Z","updatedAt":"2026-02-12T14:16:16.437Z","__v":0},{"_id":"698de08d27f1502f3265e9c4","deploymentId":"697d034dc7078c59853e519b","questionText":"How do I get authenticated?","status":"active","generatedBy":"manual","createdAt":"2026-02-12T14:15:41.708Z","updatedAt":"2026-02-12T14:15:41.708Z","__v":0}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/v1/surplus-lines-filings/get-filing","slug":"/api-reference/v1/surplus-lines-filings/get-filing","pageMetadata":{"title":"Surplus Lines Filing","description":"Retrieve a single surplus lines filing by ID","openapi":"openapi/v1.json GET /v1/surplus-lines-filings/{filingId}","href":"/api-reference/v1/surplus-lines-filings/get-filing"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retrieve a single surplus lines filing by ID\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Returns a single surplus lines filing by its unique identifier, including its escalation / action-required state and notes, and any completion artifacts (accepted/stamped filing, receipt, confirmation, tax/remittance proof) as short-lived presigned download links. The filing must belong to the authenticated upstream entity.`}),`\n`,_jsx(Heading,{level:`2`,id:`path-parameters`,children:`Path Parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:_jsx(_components.code,{children:`filingId`})})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Unique identifier of the filing (MongoDB ObjectId)`})]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`response-shape`,children:`Response Shape`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`All successful responses are wrapped in the standard response envelope. See `,_jsx(_components.a,{href:`/guides/request-response`,children:`Request/Response Conventions`}),`.`]})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`44`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`44`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"statusCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`200`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"6650a1b2c3d4e5f6a7b8c9d0\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"externalReference\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"UNION-12345\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"policyNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"POL-2025-001\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"stateCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CA\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"policyTransactionType\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"bind\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"filed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"actionRequired\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"effectiveDate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-01-15T00:00:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updatedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-01-16T10:31:45.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"namedInsured\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Example Corp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"carrier\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Lloyd's of London\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"carrierNaicCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12345\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"grossPremium\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"totalTaxDue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`494`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"escalations\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"checklistItemLabel\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Provide signed D-1 diligence form\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"waiting customer input\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"openedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-01-16T09:00:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"resolvedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"messages\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"authorLabel\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Turris\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"body\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Please upload the signed D-1 form so we can complete the filing.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"createdAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-01-16T09:00:00.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"completionArtifacts\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"accepted stamped\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"fileName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CA-SL-2-stamped.pdf\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"uploadedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-01-16T10:31:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"downloadUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://s3.amazonaws.com/...\u0026X-Amz-Expires=3600\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"viewUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://s3.amazonaws.com/...\u0026response-content-disposition=inline\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timestamp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-01-16T10:31:50.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`response-fields`,children:`Response Fields`}),`\n`,_jsxs(_components.p,{children:[`The filing carries the same summary fields as each item in `,_jsx(_components.a,{href:`/api-reference/v1/surplus-lines-filings/list-filings`,children:`List Surplus Lines Filings`}),`, plus the detail fields below.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`namedInsured`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Name of the insured party`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`carrier`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Insurance carrier name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`carrierNaicCode`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`NAIC code of the carrier`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`grossPremium`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Gross written premium`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`totalTaxDue`})}),_jsx(_components.td,{children:`number?`}),_jsx(_components.td,{children:`Total surplus lines tax due, if a tax calculation exists (null otherwise)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`escalations`})}),_jsx(_components.td,{children:`array`}),_jsx(_components.td,{children:`Open and resolved escalations on public checklist items (see below)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`completionArtifacts`})}),_jsx(_components.td,{children:`array`}),_jsx(_components.td,{children:`Completion documents as presigned links (see below)`})]})]})]}),`\n`,_jsx(Heading,{level:`4`,id:`escalation-object`,children:`Escalation object`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`checklistItemLabel`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`The checklist item the escalation is attached to`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`waiting turris input`}),`, `,_jsx(_components.code,{children:`waiting customer input`}),`, or `,_jsx(_components.code,{children:`resolved`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`openedAt`})}),_jsx(_components.td,{children:`string?`}),_jsx(_components.td,{children:`ISO 8601 timestamp when the escalation was opened`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`resolvedAt`})}),_jsx(_components.td,{children:`string?`}),_jsx(_components.td,{children:`ISO 8601 timestamp when it was resolved (null if open)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`messages`})}),_jsx(_components.td,{children:`array`}),_jsxs(_components.td,{children:[`Thread of messages, each with `,_jsx(_components.code,{children:`authorLabel`}),` (`,_jsx(_components.code,{children:`Turris`}),` or your agency), `,_jsx(_components.code,{children:`body`}),`, and `,_jsx(_components.code,{children:`createdAt`})]})]})]})]}),`\n`,_jsx(Heading,{level:`4`,id:`completion-artifact-object`,children:`Completion artifact object`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`type`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`accepted stamped`}),`, `,_jsx(_components.code,{children:`receipt`}),`, `,_jsx(_components.code,{children:`confirmation`}),`, or `,_jsx(_components.code,{children:`tax remittance proof`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`fileName`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Original file name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`uploadedAt`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`ISO 8601 timestamp when the artifact was attached`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`downloadUrl`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Presigned download link (attachment; expires in ~1 hour)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`viewUrl`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Presigned inline-view link (expires in ~1 hour)`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`downloadUrl`}),` and `,_jsx(_components.code,{children:`viewUrl`}),` are short-lived presigned links. Fetch them fresh from this endpoint when you need to download an artifact rather than storing the URL.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`error-scenarios`,children:`Error Scenarios`}),`\n`,_jsx(Heading,{level:`3`,id:`bad-request-400`,children:`Bad Request (400)`}),`\n`,_jsxs(_components.p,{children:[`Returned when `,_jsx(_components.code,{children:`filingId`}),` is not a valid MongoDB ObjectId format.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"statusCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`400`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"errorType\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"validation_error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"errorMessage\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"filingId must be a mongodb id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"requestId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"dev-abc123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timestamp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-01-16T10:30:00.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`filing-not-found-404`,children:`Filing Not Found (404)`}),`\n`,_jsxs(_components.p,{children:[`Returned when `,_jsx(_components.code,{children:`filingId`}),` doesn’t exist or belongs to a different upstream entity.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"statusCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`404`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"errorType\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"not_found\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"errorMessage\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Surplus-lines filing not found\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"requestId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"dev-abc123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timestamp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-01-16T10:30:00.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`unauthorized-401`,children:`Unauthorized (401)`}),`\n`,_jsxs(_components.p,{children:[`Missing or invalid authentication token. See `,_jsx(_components.a,{href:`/authentication`,children:`Authentication`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Surplus Lines Filing","description":"Retrieve a single surplus lines filing by ID","openapi":"openapi/v1.json GET /v1/surplus-lines-filings/{filingId}","href":"/api-reference/v1/surplus-lines-filings/get-filing"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Path Parameters","slug":"path-parameters","depth":2,"children":[]},{"title":"Response Shape","slug":"response-shape","depth":2,"children":[{"title":"Response Fields","slug":"response-fields","depth":3,"children":[]},{"title":"Escalation object","slug":"escalation-object","depth":4,"children":[]},{"title":"Completion artifact object","slug":"completion-artifact-object","depth":4,"children":[]}]},{"title":"Error Scenarios","slug":"error-scenarios","depth":2,"children":[{"title":"Bad Request (400)","slug":"bad-request-400","depth":3,"children":[]},{"title":"Filing Not Found (404)","slug":"filing-not-found-404","depth":3,"children":[]},{"title":"Unauthorized (401)","slug":"unauthorized-401","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/turris/0c051c093ff073c0/scripts/filter-openapi.js"],"openApiReferenceData":{"operation":{"operationId":"SurplusLinesFilingsController_getFiling_v1","parameters":["3df82822-bcab-4d40-9f02-90ece7ca6b7c"],"responses":{"200":"5d1e81d8-2db8-4542-8fa6-252e9dc945a0","400":"f4b5de68-d8be-47ba-a252-0e339ad026b7","401":"df496c1d-9ff7-4844-b914-9721c0ea0f71","403":"46ba4431-732a-4b86-be39-10f2a86af038","404":"3beceeb8-10f9-4a1b-99ce-659b3b1e4f25","429":"9c0365af-25bd-42a6-b86d-b7d3a3d48c1d"},"tags":["surplus-lines-filings"],"method":"get","type":"path","servers":["a05bdd51-68db-4ee9-be34-9b8198412954","b1acce2c-c162-4ffd-87ef-994ad2fbe24e"],"security":["4999e4d2-dc27-49bc-8a8c-c72b27da9f19","26aa7122-40e2-4b3a-9060-09b2b11c7b9c"],"path":"/v1/surplus-lines-filings/{filingId}","baseUrlOptions":["https://public.api.live.turrisfi.com","https://public.api.sandbox.turrisfi.com"],"title":"","description":"Retrieve a single surplus lines filing by ID","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{"3df82822-bcab-4d40-9f02-90ece7ca6b7c":{"name":"filingId","required":true,"in":"path","description":"Unique identifier of the surplus-lines filing","schema":{"example":"6650a1b2c3d4e5f6a7b8c9d0","type":"string","isRequired":true,"description":"Unique identifier of the surplus-lines filing","uniqueKey":"","typeLabel":"string"}}},"responses":{"5d1e81d8-2db8-4542-8fa6-252e9dc945a0":{"description":"Surplus-lines filing detail with escalations and completion artifacts","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"_id":{"type":"string","description":"Unique identifier of the filing","example":"6650a1b2c3d4e5f6a7b8c9d0","isRequired":true,"uniqueKey":"data._id","typeLabel":"string"},"policyNumber":{"type":"string","description":"Policy number","example":"POL-2025-001","isRequired":true,"uniqueKey":"data.policyNumber","typeLabel":"string"},"stateCode":{"type":"string","description":"US state or territory code where the risk is located","enum":["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","isRequired":true,"uniqueKey":"data.stateCode","typeLabel":"enum\u003cstring>"},"policyTransactionType":{"type":"string","description":"Type of policy transaction","enum":["bind","endorsement","renewal","cancellation"],"example":"bind","isRequired":true,"uniqueKey":"data.policyTransactionType","typeLabel":"enum\u003cstring>"},"status":{"type":"string","description":"Current status of the filing","enum":["not started","in progress","ready to file","filed","completed","on hold","canceled"],"example":"in progress","isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"actionRequired":{"type":"boolean","description":"True when at least one public-category escalation is waiting for the customer","isRequired":true,"uniqueKey":"data.actionRequired","typeLabel":"boolean"},"updatedAt":{"type":"string","description":"ISO 8601 timestamp of the last update","example":"2025-06-15T12:00:00.000Z","isRequired":true,"uniqueKey":"data.updatedAt","typeLabel":"string"},"namedInsured":{"type":"string","description":"Named insured on the policy","example":"Example Corp","isRequired":true,"uniqueKey":"data.namedInsured","typeLabel":"string"},"carrier":{"type":"string","description":"Carrier name","example":"Lloyds of London","isRequired":true,"uniqueKey":"data.carrier","typeLabel":"string"},"carrierNaicCode":{"type":"string","description":"Carrier NAIC code","example":"12345","isRequired":true,"uniqueKey":"data.carrierNaicCode","typeLabel":"string"},"grossPremium":{"type":"number","description":"Gross premium amount in USD","example":5000,"isRequired":true,"uniqueKey":"data.grossPremium","typeLabel":"number"},"escalations":{"description":"Public-category escalations for this filing (open or resolved)","type":"array","items":{"type":"object","properties":{"checklistItemLabel":{"type":"string","description":"The checklist item label this escalation is attached to","isRequired":true,"uniqueKey":"data.escalations.items.[INDEX].checklistItemLabel","typeLabel":"string"},"status":{"type":"string","description":"Current status of the escalation","enum":["waiting turris input","waiting customer input","resolved"],"example":"waiting customer input","isRequired":true,"uniqueKey":"data.escalations.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"messages":{"description":"Chronological list of messages on this escalation","type":"array","items":{"type":"object","properties":{"authorLabel":{"type":"string","description":"Display label for the message author (Turris or Agency)","example":"Turris","isRequired":true,"uniqueKey":"data.escalations.items.[INDEX].messages.items.[INDEX].authorLabel","typeLabel":"string"},"body":{"type":"string","description":"Message body text","isRequired":true,"uniqueKey":"data.escalations.items.[INDEX].messages.items.[INDEX].body","typeLabel":"string"},"createdAt":{"type":"string","description":"ISO 8601 timestamp when the message was created","example":"2025-06-01T12:00:00.000Z","isRequired":true,"uniqueKey":"data.escalations.items.[INDEX].messages.items.[INDEX].createdAt","typeLabel":"string"}},"required":["authorLabel","body","createdAt"],"uniqueKey":"data.escalations.items.[INDEX].messages.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.escalations.items.[INDEX].messages","typeLabel":"object[]"},"openedAt":{"oneOf":[{"type":"string","description":"ISO 8601 timestamp when the escalation was opened","uniqueKey":"data.escalations.items.[INDEX].openedAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"ISO 8601 timestamp when the escalation was opened","uniqueKey":"data.escalations.items.[INDEX].openedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.escalations.items.[INDEX].openedAt","typeLabel":"string | null"},"resolvedAt":{"oneOf":[{"type":"string","description":"ISO 8601 timestamp when the escalation was resolved","uniqueKey":"data.escalations.items.[INDEX].resolvedAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"ISO 8601 timestamp when the escalation was resolved","uniqueKey":"data.escalations.items.[INDEX].resolvedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.escalations.items.[INDEX].resolvedAt","typeLabel":"string | null"}},"required":["checklistItemLabel","status","messages"],"uniqueKey":"data.escalations.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.escalations","typeLabel":"object[]"},"completionArtifacts":{"description":"Completion artifacts uploaded when the filing reached Completed status","type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"Type of completion artifact","enum":["accepted stamped","receipt","confirmation","tax remittance proof"],"example":"accepted stamped","isRequired":true,"uniqueKey":"data.completionArtifacts.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"fileName":{"type":"string","description":"Original file name of the artifact","example":"stamped-filing.pdf","isRequired":true,"uniqueKey":"data.completionArtifacts.items.[INDEX].fileName","typeLabel":"string"},"uploadedAt":{"type":"string","description":"ISO 8601 timestamp when the artifact was uploaded","example":"2025-06-15T09:00:00.000Z","isRequired":true,"uniqueKey":"data.completionArtifacts.items.[INDEX].uploadedAt","typeLabel":"string"},"downloadUrl":{"type":"string","description":"Short-lived presigned URL to download the artifact file","isRequired":true,"uniqueKey":"data.completionArtifacts.items.[INDEX].downloadUrl","typeLabel":"string"},"viewUrl":{"type":"string","description":"Short-lived presigned URL to view the artifact inline in the browser","isRequired":true,"uniqueKey":"data.completionArtifacts.items.[INDEX].viewUrl","typeLabel":"string"}},"required":["type","fileName","uploadedAt","downloadUrl","viewUrl"],"uniqueKey":"data.completionArtifacts.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.completionArtifacts","typeLabel":"object[]"},"checklist":{"description":"Customer-visible checklist for this filing. Internal categories are never included, so this is the outstanding work you can act on. Each item nests its own escalation; the flat escalations[] above is the same set of threads, kept for backward compatibility.","type":"array","items":{"type":"object","properties":{"sourceCategoryId":{"type":"string","description":"Identifier of the category","example":"6650a1b2c3d4e5f6a7b8c9d0","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].sourceCategoryId","typeLabel":"string"},"name":{"type":"string","description":"Category name","example":"Documents we need from you","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].name","typeLabel":"string"},"tone":{"type":"string","description":"Display tone for the category","enum":["primary","secondary","neutral","green","red","yellow"],"example":"primary","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].tone","typeLabel":"enum\u003cstring>"},"order":{"type":"number","description":"Display order of the category within the checklist","example":0,"isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].order","typeLabel":"number"},"items":{"description":"Items in this category","type":"array","items":{"type":"object","properties":{"sourceCategoryId":{"type":"string","description":"Identifier of the category this item belongs to. Repeated on the item as well as on its parent category so that the (sourceCategoryId, sourceTaskId) pair survives flattening: checklist.flatMap((category) => category.items) is how you find outstanding items, and it discards the parent.","example":"6650a1b2c3d4e5f6a7b8c9d0","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].sourceCategoryId","typeLabel":"string"},"sourceTaskId":{"type":"string","description":"Identifier of this item. Together with sourceCategoryId it identifies the item within THIS filing, which is what lets you match an item to the same item on a later poll. The pair is unique within one filing only: both ids come from the state template, so they are identical across every filing in the same state and across tenants. Key any client-side cache by filing id as well, or two filings in one state will collide.","example":"6650a1b2c3d4e5f6a7b8c9d1","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].sourceTaskId","typeLabel":"string"},"label":{"type":"string","description":"What the item asks for","example":"Signed diligent search affidavit","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].label","typeLabel":"string"},"required":{"type":"boolean","description":"True when the filing cannot complete without this item","example":true,"isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].required","typeLabel":"boolean"},"order":{"type":"number","description":"Display order of the item within its category","example":0,"isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].order","typeLabel":"number"},"checked":{"type":"boolean","description":"True once Turris has satisfied the item","example":false,"isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].checked","typeLabel":"boolean"},"referenceFields":{"description":"Reference values captured against this item","type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"Field label as configured on the state template","example":"Policy limit","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].referenceFields.items.[INDEX].label","typeLabel":"string"},"value":{"type":"string","description":"Value captured for this field; empty string when not yet filled in","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].referenceFields.items.[INDEX].value","typeLabel":"string"}},"required":["label","value"],"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].referenceFields.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].referenceFields","typeLabel":"object[]"},"templateFiles":{"description":"Blank forms supplied for this item, each with short-lived presigned links","type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identifier of the template file","example":"6650a1b2c3d4e5f6a7b8c9d0","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].templateFiles.items.[INDEX].id","typeLabel":"string"},"fileName":{"type":"string","description":"Original file name","example":"diligent-search-form.pdf","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].templateFiles.items.[INDEX].fileName","typeLabel":"string"},"mimeType":{"type":"string","description":"MIME type of the file","example":"application/pdf","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].templateFiles.items.[INDEX].mimeType","typeLabel":"string"},"fileSize":{"type":"number","description":"File size in bytes","example":248310,"isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].templateFiles.items.[INDEX].fileSize","typeLabel":"number"},"description":{"type":"string","description":"Description of what the file is for; empty string when none was set","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].templateFiles.items.[INDEX].description","typeLabel":"string"},"downloadUrl":{"type":"string","description":"Short-lived presigned URL to download the file","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].templateFiles.items.[INDEX].downloadUrl","typeLabel":"string"},"viewUrl":{"type":"string","description":"Short-lived presigned URL to view the file inline in the browser","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].templateFiles.items.[INDEX].viewUrl","typeLabel":"string"}},"required":["id","fileName","mimeType","fileSize","description","downloadUrl","viewUrl"],"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].templateFiles.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].templateFiles","typeLabel":"object[]"},"attachments":{"description":"Files attached to this item, each with short-lived presigned links","type":"array","items":{"type":"object","properties":{"_id":{"type":"string","description":"Identifier of the attachment","example":"6650a1b2c3d4e5f6a7b8c9d0","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].attachments.items.[INDEX]._id","typeLabel":"string"},"fileName":{"type":"string","description":"Original file name","example":"signed-form.pdf","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].attachments.items.[INDEX].fileName","typeLabel":"string"},"uploadedByType":{"type":"string","description":"Who uploaded the file","enum":["admin","customer"],"example":"customer","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].attachments.items.[INDEX].uploadedByType","typeLabel":"enum\u003cstring>"},"uploadedAt":{"type":"string","description":"ISO 8601 timestamp when the file was uploaded","example":"2026-06-01T12:00:00.000Z","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].attachments.items.[INDEX].uploadedAt","typeLabel":"string"},"authorLabel":{"type":"string","description":"Who uploaded the file, as a display label: 'Turris' for a Turris upload, otherwise the name of the entity the filing belongs to. Uploader ids are never returned.","example":"Turris","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].attachments.items.[INDEX].authorLabel","typeLabel":"string"},"downloadUrl":{"type":"string","description":"Short-lived presigned URL to download the file","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].attachments.items.[INDEX].downloadUrl","typeLabel":"string"},"viewUrl":{"type":"string","description":"Short-lived presigned URL to view the file inline in the browser","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].attachments.items.[INDEX].viewUrl","typeLabel":"string"}},"required":["_id","fileName","uploadedByType","uploadedAt","authorLabel","downloadUrl","viewUrl"],"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].attachments.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].attachments","typeLabel":"object[]"},"checkedAt":{"oneOf":[{"type":"string","description":"ISO 8601 timestamp when the item was checked off; null while outstanding","example":"2026-06-01T12:00:00.000Z","uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].checkedAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"ISO 8601 timestamp when the item was checked off; null while outstanding","example":"2026-06-01T12:00:00.000Z","uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].checkedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].checkedAt","typeLabel":"string | null"},"escalation":{"oneOf":[{"type":"object","description":"Escalation raised on this item; null when none was raised. Also listed on the filing escalations[].","required":["checklistItemLabel","status","messages"],"properties":{"checklistItemLabel":{"type":"string","description":"The checklist item label this escalation is attached to","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].escalation.oneOf.0.checklistItemLabel","typeLabel":"string"},"status":{"type":"string","description":"Current status of the escalation","enum":["waiting turris input","waiting customer input","resolved"],"example":"waiting customer input","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].escalation.oneOf.0.status","typeLabel":"enum\u003cstring>"},"messages":{"description":"Chronological list of messages on this escalation","type":"array","items":{"type":"object","properties":{"authorLabel":{"type":"string","description":"Display label for the message author (Turris or Agency)","example":"Turris","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].escalation.oneOf.0.messages.items.[INDEX].authorLabel","typeLabel":"string"},"body":{"type":"string","description":"Message body text","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].escalation.oneOf.0.messages.items.[INDEX].body","typeLabel":"string"},"createdAt":{"type":"string","description":"ISO 8601 timestamp when the message was created","example":"2025-06-01T12:00:00.000Z","isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].escalation.oneOf.0.messages.items.[INDEX].createdAt","typeLabel":"string"}},"required":["authorLabel","body","createdAt"],"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].escalation.oneOf.0.messages.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].escalation.oneOf.0.messages","typeLabel":"object[]"},"openedAt":{"oneOf":[{"type":"string","description":"ISO 8601 timestamp when the escalation was opened","uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].escalation.oneOf.0.openedAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"ISO 8601 timestamp when the escalation was opened","uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].escalation.oneOf.0.openedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].escalation.oneOf.0.openedAt","typeLabel":"string | null"},"resolvedAt":{"oneOf":[{"type":"string","description":"ISO 8601 timestamp when the escalation was resolved","uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].escalation.oneOf.0.resolvedAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"ISO 8601 timestamp when the escalation was resolved","uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].escalation.oneOf.0.resolvedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].escalation.oneOf.0.resolvedAt","typeLabel":"string | null"}},"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].escalation.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].escalation.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX].escalation","typeLabel":"object | null"}},"required":["sourceCategoryId","sourceTaskId","label","required","order","checked","referenceFields","templateFiles","attachments"],"uniqueKey":"data.checklist.items.[INDEX].\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.checklist.items.[INDEX].\\items","typeLabel":"object[]"}},"required":["sourceCategoryId","name","tone","order","items"],"uniqueKey":"data.checklist.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.checklist","typeLabel":"object[]"},"checklistProgress":{"type":"object","description":"Checked/total counts over the visible checklist items only","required":["checked","total"],"properties":{"checked":{"type":"number","description":"How many visible checklist items are done","example":3,"isRequired":true,"uniqueKey":"data.checklistProgress.checked","typeLabel":"number"},"total":{"type":"number","description":"How many visible checklist items there are in total","example":5,"isRequired":true,"uniqueKey":"data.checklistProgress.total","typeLabel":"number"}},"isRequired":true,"uniqueKey":"data.checklistProgress","typeLabel":"object"},"externalReference":{"oneOf":[{"type":"string","description":"External reference identifier assigned by the caller","example":"EXT-REF-12345","uniqueKey":"data.externalReference.oneOf.0","typeLabel":"string"},{"type":"null","description":"External reference identifier assigned by the caller","example":"EXT-REF-12345","uniqueKey":"data.externalReference.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.externalReference","typeLabel":"string | null"},"effectiveDate":{"oneOf":[{"type":"string","description":"ISO 8601 policy effective date","example":"2025-01-01T00:00:00.000Z","uniqueKey":"data.effectiveDate.oneOf.0","typeLabel":"string"},{"type":"null","description":"ISO 8601 policy effective date","example":"2025-01-01T00:00:00.000Z","uniqueKey":"data.effectiveDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.effectiveDate","typeLabel":"string | null"},"totalTaxDue":{"oneOf":[{"type":"number","description":"Total tax due in USD; null when no tax snapshot exists","uniqueKey":"data.totalTaxDue.oneOf.0","typeLabel":"number"},{"type":"null","description":"Total tax due in USD; null when no tax snapshot exists","uniqueKey":"data.totalTaxDue.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.totalTaxDue","typeLabel":"number | null"},"policyDocument":{"oneOf":[{"type":"object","description":"The policy document attached to this filing, or null if none has been uploaded yet","required":["fileName","uploadedByType","uploadedAt","downloadUrl","viewUrl"],"properties":{"fileName":{"type":"string","description":"Original file name of the policy document","example":"policy-12345.pdf","isRequired":true,"uniqueKey":"data.policyDocument.oneOf.0.fileName","typeLabel":"string"},"uploadedByType":{"type":"string","description":"Who uploaded the policy document","enum":["admin","customer"],"example":"customer","isRequired":true,"uniqueKey":"data.policyDocument.oneOf.0.uploadedByType","typeLabel":"enum\u003cstring>"},"uploadedAt":{"type":"string","description":"ISO 8601 timestamp when the policy document was uploaded","example":"2025-06-15T09:00:00.000Z","isRequired":true,"uniqueKey":"data.policyDocument.oneOf.0.uploadedAt","typeLabel":"string"},"downloadUrl":{"type":"string","description":"Short-lived presigned URL to download the policy document","isRequired":true,"uniqueKey":"data.policyDocument.oneOf.0.downloadUrl","typeLabel":"string"},"viewUrl":{"type":"string","description":"Short-lived presigned URL to view the policy document inline in the browser","isRequired":true,"uniqueKey":"data.policyDocument.oneOf.0.viewUrl","typeLabel":"string"}},"uniqueKey":"data.policyDocument.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.policyDocument.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.policyDocument","typeLabel":"object | null"}},"required":["_id","policyNumber","stateCode","policyTransactionType","status","actionRequired","updatedAt","namedInsured","carrier","carrierNaicCode","grossPremium","escalations","completionArtifacts","checklist","checklistProgress"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"},"requestId":{"type":"string","description":"Unique request identifier","example":"dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"timestamp":{"type":"string","description":"Response timestamp","example":"2025-11-12T20:49:03.293Z","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string"}},"required":["data","requestId","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"_id":"6650a1b2c3d4e5f6a7b8c9d0","policyNumber":"POL-2025-001","stateCode":"CA","policyTransactionType":"bind","status":"in progress","actionRequired":true,"updatedAt":"2025-06-15T12:00:00.000Z","namedInsured":"Example Corp","carrier":"Lloyds of London","carrierNaicCode":"12345","grossPremium":5000,"escalations":[{"checklistItemLabel":"\u003cstring>","status":"waiting customer input","messages":[{"authorLabel":"Turris","body":"\u003cstring>","createdAt":"2025-06-01T12:00:00.000Z"}],"openedAt":"\u003cstring>","resolvedAt":"\u003cstring>"}],"completionArtifacts":[{"type":"accepted stamped","fileName":"stamped-filing.pdf","uploadedAt":"2025-06-15T09:00:00.000Z","downloadUrl":"\u003cstring>","viewUrl":"\u003cstring>"}],"checklist":[{"sourceCategoryId":"6650a1b2c3d4e5f6a7b8c9d0","name":"Documents we need from you","tone":"primary","order":0,"items":[{"sourceCategoryId":"6650a1b2c3d4e5f6a7b8c9d0","sourceTaskId":"6650a1b2c3d4e5f6a7b8c9d1","label":"Signed diligent search affidavit","required":true,"order":0,"checked":false,"referenceFields":[{"label":"Policy limit","value":"\u003cstring>"}],"templateFiles":[{"id":"6650a1b2c3d4e5f6a7b8c9d0","fileName":"diligent-search-form.pdf","mimeType":"application/pdf","fileSize":248310,"description":"\u003cstring>","downloadUrl":"\u003cstring>","viewUrl":"\u003cstring>"}],"attachments":[{"_id":"6650a1b2c3d4e5f6a7b8c9d0","fileName":"signed-form.pdf","uploadedByType":"customer","uploadedAt":"2026-06-01T12:00:00.000Z","authorLabel":"Turris","downloadUrl":"\u003cstring>","viewUrl":"\u003cstring>"}],"checkedAt":"2026-06-01T12:00:00.000Z","escalation":{"checklistItemLabel":"\u003cstring>","status":"waiting customer input","messages":[{"authorLabel":"Turris","body":"\u003cstring>","createdAt":"2025-06-01T12:00:00.000Z"}],"openedAt":"\u003cstring>","resolvedAt":"\u003cstring>"}}]}],"checklistProgress":{"checked":3,"total":5},"externalReference":"EXT-REF-12345","effectiveDate":"2025-01-01T00:00:00.000Z","totalTaxDue":123,"policyDocument":{"fileName":"policy-12345.pdf","uploadedByType":"customer","uploadedAt":"2025-06-15T09:00:00.000Z","downloadUrl":"\u003cstring>","viewUrl":"\u003cstring>"}},"requestId":"dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8","timestamp":"2025-11-12T20:49:03.293Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"f4b5de68-d8be-47ba-a252-0e339ad026b7":{"description":"Invalid filingId format","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"requestId":{"type":"string","description":"Unique request identifier for debugging","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"errorType":{"type":"string","description":"Machine-readable error classification. Branch on this rather than on `errorMessage`, which is prose and may change. Authentication failures returned by our identity provider are forwarded verbatim, so a 401 can carry a code outside this list; treat an unrecognised value as a generic failure of its HTTP status.","enum":["conflict","contact_not_authorized","document_exceeds_page_limit","downstream_entity_member_exists","duplicate_external_id_error","duplicate_member_email","duplicate_producer_code_error","forbidden","gateway_timeout","inactive_email","internal_server_error","invalid_email","invalid_email_for_invites","invalid_organization_category","invalid_organization_slug","invalid_phone_number","invalid_token","invite_limit_reached","jwt_invalid","m2m_client_not_found","not_found","organization_already_exists","organization_slug_already_used","payment_required","producer_agreement_required","product_feature_subscription_required","service_unavailable","session_authorization_error","some_custom_error_string","throttled","too_many_requests","unauthorized","unauthorized_client","unexpected_400_stytch_error","unexpected_403_stytch_error","unexpected_404_stytch_error","unexpected_error","unexpected_stytch_error","unprocessable_entity","validation_error"],"example":"validation_error","isRequired":true,"uniqueKey":"errorType","typeLabel":"enum\u003cstring>"},"errorMessage":{"description":"Array of error messages","type":"array","items":{"type":"string","uniqueKey":"errorMessage.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"errorMessage","typeLabel":"string[]"},"timestamp":{"type":"string","description":"ISO timestamp when the error occurred","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string"},"details":{"type":"object","description":"Additional error context","uniqueKey":"details","typeLabel":"object"}},"required":["statusCode","requestId","errorType","errorMessage","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":123,"requestId":"\u003cstring>","errorType":"validation_error","errorMessage":["\u003cstring>"],"timestamp":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"df496c1d-9ff7-4844-b914-9721c0ea0f71":{"description":"Invalid or missing auth token","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"requestId":{"type":"string","description":"Unique request identifier for debugging","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"errorType":{"type":"string","description":"Machine-readable error classification. Branch on this rather than on `errorMessage`, which is prose and may change. Authentication failures returned by our identity provider are forwarded verbatim, so a 401 can carry a code outside this list; treat an unrecognised value as a generic failure of its HTTP status.","enum":["conflict","contact_not_authorized","document_exceeds_page_limit","downstream_entity_member_exists","duplicate_external_id_error","duplicate_member_email","duplicate_producer_code_error","forbidden","gateway_timeout","inactive_email","internal_server_error","invalid_email","invalid_email_for_invites","invalid_organization_category","invalid_organization_slug","invalid_phone_number","invalid_token","invite_limit_reached","jwt_invalid","m2m_client_not_found","not_found","organization_already_exists","organization_slug_already_used","payment_required","producer_agreement_required","product_feature_subscription_required","service_unavailable","session_authorization_error","some_custom_error_string","throttled","too_many_requests","unauthorized","unauthorized_client","unexpected_400_stytch_error","unexpected_403_stytch_error","unexpected_404_stytch_error","unexpected_error","unexpected_stytch_error","unprocessable_entity","validation_error"],"example":"validation_error","isRequired":true,"uniqueKey":"errorType","typeLabel":"enum\u003cstring>"},"errorMessage":{"description":"Array of error messages","type":"array","items":{"type":"string","uniqueKey":"errorMessage.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"errorMessage","typeLabel":"string[]"},"timestamp":{"type":"string","description":"ISO timestamp when the error occurred","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string"},"details":{"type":"object","description":"Additional error context","uniqueKey":"details","typeLabel":"object"}},"required":["statusCode","requestId","errorType","errorMessage","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":123,"requestId":"\u003cstring>","errorType":"validation_error","errorMessage":["\u003cstring>"],"timestamp":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"46ba4431-732a-4b86-be39-10f2a86af038":{"description":"Returned with `errorType` `invalid_organization_category` when your credential's organization category does not match the one this endpoint serves; `details` names the expected and actual category. This endpoint can return 403 for other reasons too, so branch on `errorType`; the Error Handling guide lists them.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"requestId":{"type":"string","description":"Unique request identifier for debugging","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"errorType":{"type":"string","description":"Machine-readable error classification. Branch on this rather than on `errorMessage`, which is prose and may change. Authentication failures returned by our identity provider are forwarded verbatim, so a 401 can carry a code outside this list; treat an unrecognised value as a generic failure of its HTTP status.","enum":["conflict","contact_not_authorized","document_exceeds_page_limit","downstream_entity_member_exists","duplicate_external_id_error","duplicate_member_email","duplicate_producer_code_error","forbidden","gateway_timeout","inactive_email","internal_server_error","invalid_email","invalid_email_for_invites","invalid_organization_category","invalid_organization_slug","invalid_phone_number","invalid_token","invite_limit_reached","jwt_invalid","m2m_client_not_found","not_found","organization_already_exists","organization_slug_already_used","payment_required","producer_agreement_required","product_feature_subscription_required","service_unavailable","session_authorization_error","some_custom_error_string","throttled","too_many_requests","unauthorized","unauthorized_client","unexpected_400_stytch_error","unexpected_403_stytch_error","unexpected_404_stytch_error","unexpected_error","unexpected_stytch_error","unprocessable_entity","validation_error"],"example":"validation_error","isRequired":true,"uniqueKey":"errorType","typeLabel":"enum\u003cstring>"},"errorMessage":{"description":"Array of error messages","type":"array","items":{"type":"string","uniqueKey":"errorMessage.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"errorMessage","typeLabel":"string[]"},"timestamp":{"type":"string","description":"ISO timestamp when the error occurred","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string"},"details":{"type":"object","description":"Additional error context","uniqueKey":"details","typeLabel":"object"}},"required":["statusCode","requestId","errorType","errorMessage","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":123,"requestId":"\u003cstring>","errorType":"validation_error","errorMessage":["\u003cstring>"],"timestamp":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"3beceeb8-10f9-4a1b-99ce-659b3b1e4f25":{"description":"Filing not found or belongs to a different upstream entity","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"requestId":{"type":"string","description":"Unique request identifier for debugging","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"errorType":{"type":"string","description":"Machine-readable error classification. Branch on this rather than on `errorMessage`, which is prose and may change. Authentication failures returned by our identity provider are forwarded verbatim, so a 401 can carry a code outside this list; treat an unrecognised value as a generic failure of its HTTP status.","enum":["conflict","contact_not_authorized","document_exceeds_page_limit","downstream_entity_member_exists","duplicate_external_id_error","duplicate_member_email","duplicate_producer_code_error","forbidden","gateway_timeout","inactive_email","internal_server_error","invalid_email","invalid_email_for_invites","invalid_organization_category","invalid_organization_slug","invalid_phone_number","invalid_token","invite_limit_reached","jwt_invalid","m2m_client_not_found","not_found","organization_already_exists","organization_slug_already_used","payment_required","producer_agreement_required","product_feature_subscription_required","service_unavailable","session_authorization_error","some_custom_error_string","throttled","too_many_requests","unauthorized","unauthorized_client","unexpected_400_stytch_error","unexpected_403_stytch_error","unexpected_404_stytch_error","unexpected_error","unexpected_stytch_error","unprocessable_entity","validation_error"],"example":"validation_error","isRequired":true,"uniqueKey":"errorType","typeLabel":"enum\u003cstring>"},"errorMessage":{"description":"Array of error messages","type":"array","items":{"type":"string","uniqueKey":"errorMessage.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"errorMessage","typeLabel":"string[]"},"timestamp":{"type":"string","description":"ISO timestamp when the error occurred","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string"},"details":{"type":"object","description":"Additional error context","uniqueKey":"details","typeLabel":"object"}},"required":["statusCode","requestId","errorType","errorMessage","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":123,"requestId":"\u003cstring>","errorType":"validation_error","errorMessage":["\u003cstring>"],"timestamp":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"9c0365af-25bd-42a6-b86d-b7d3a3d48c1d":{"description":"Too many requests: this credential passed the API-wide limit of 1000 requests per 10 seconds, counted across every endpoint. The request was not processed. Wait the number of seconds in the Retry-After header, then retry.","headers":{"Retry-After":{"description":"Seconds to wait before retrying. Sent when a rate limit refused the request.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"requestId":{"type":"string","description":"Unique request identifier for debugging","isRequired":true,"uniqueKey":"requestId","typeLabel":"string"},"errorType":{"type":"string","description":"Machine-readable error classification. Branch on this rather than on `errorMessage`, which is prose and may change. Authentication failures returned by our identity provider are forwarded verbatim, so a 401 can carry a code outside this list; treat an unrecognised value as a generic failure of its HTTP status.","enum":["conflict","contact_not_authorized","document_exceeds_page_limit","downstream_entity_member_exists","duplicate_external_id_error","duplicate_member_email","duplicate_producer_code_error","forbidden","gateway_timeout","inactive_email","internal_server_error","invalid_email","invalid_email_for_invites","invalid_organization_category","invalid_organization_slug","invalid_phone_number","invalid_token","invite_limit_reached","jwt_invalid","m2m_client_not_found","not_found","organization_already_exists","organization_slug_already_used","payment_required","producer_agreement_required","product_feature_subscription_required","service_unavailable","session_authorization_error","some_custom_error_string","throttled","too_many_requests","unauthorized","unauthorized_client","unexpected_400_stytch_error","unexpected_403_stytch_error","unexpected_404_stytch_error","unexpected_error","unexpected_stytch_error","unprocessable_entity","validation_error"],"example":"validation_error","isRequired":true,"uniqueKey":"errorType","typeLabel":"enum\u003cstring>"},"errorMessage":{"description":"Array of error messages","type":"array","items":{"type":"string","uniqueKey":"errorMessage.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"errorMessage","typeLabel":"string[]"},"timestamp":{"type":"string","description":"ISO timestamp when the error occurred","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string"},"details":{"type":"object","description":"Additional error context","uniqueKey":"details","typeLabel":"object"}},"required":["statusCode","requestId","errorType","errorMessage","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":123,"requestId":"\u003cstring>","errorType":"validation_error","errorMessage":["\u003cstring>"],"timestamp":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"4999e4d2-dc27-49bc-8a8c-c72b27da9f19":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http","scopes":[],"schemeName":"bearer"}},"26aa7122-40e2-4b3a-9060-09b2b11c7b9c":{"restricted-access-token":{"type":"apiKey","in":"header","name":"x-restricted-access-token","description":"Alternative authentication: Restricted access token (if not using Bearer token)","scopes":[],"schemeName":"restricted-access-token"}}},"servers":{"a05bdd51-68db-4ee9-be34-9b8198412954":{"url":"https://public.api.live.turrisfi.com","description":"Production"},"b1acce2c-c162-4ffd-87ef-994ad2fbe24e":{"url":"https://public.api.sandbox.turrisfi.com","description":"Sandbox"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"bearer","bearerFormat":"JWT","type":"http","scopes":[],"schemeName":"bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer","name":"Authorization"}],"title":"bearer"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-restricted-access-token","description":"Alternative authentication: Restricted access token (if not using Bearer token)","scopes":[],"schemeName":"restricted-access-token"},"schema":{"title":"x-restricted-access-token","type":"string","description":"Alternative authentication: Restricted access token (if not using Bearer token)","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"restricted-access-token","name":"x-restricted-access-token"}],"title":"restricted-access-token"}]},"originalFileLocation":"openapi/v1.json"},"subdomain":"turris","siteName":"Turris Public API","title":"Surplus Lines Filing - Turris Public API","relatedPagesConfig":{"enabled":true,"limit":3,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{"v2":{"href":"/api-reference/v2/surplus-lines-filings/get-filing","matchLevel":1},"v1":{"href":"/api-reference/v1/surplus-lines-filings/get-filing","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T22:37:41.373Z","originalFileLocation":"api-reference/v1/surplus-lines-filings/get-filing.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieve a single surplus lines filing by ID\">\u003cmeta data-mint-head name=\"application-name\" content=\"Turris Public API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/turris/UYm7mYboWneVSCYG/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/turris/UYm7mYboWneVSCYG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/turris/UYm7mYboWneVSCYG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/turris/UYm7mYboWneVSCYG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/turris/UYm7mYboWneVSCYG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/turris/UYm7mYboWneVSCYG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/turris/UYm7mYboWneVSCYG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/turris/UYm7mYboWneVSCYG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/turris/UYm7mYboWneVSCYG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Surplus Lines Filing - Turris Public API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve a single surplus lines filing by ID\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Turris Public API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.turrisfi.com/api-reference/v1/surplus-lines-filings/get-filing\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://turris.mintlify.site/_mintlify/api/og/v2?division=Surplus+Lines+Filings\u0026amp;title=Surplus+Lines+Filing\u0026amp;description=Retrieve+a+single+surplus+lines+filing+by+ID\u0026amp;theme=c46ece167b2fe61e15f5803d\u0026amp;signature=ea5cd231ce532446730427e7b1baeea1e6d048cd3e05dd7c1d7f59713e635e3a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Surplus Lines Filing - Turris Public API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve a single surplus lines filing by ID\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://turris.mintlify.site/_mintlify/api/og/v2?division=Surplus+Lines+Filings\u0026amp;title=Surplus+Lines+Filing\u0026amp;description=Retrieve+a+single+surplus+lines+filing+by+ID\u0026amp;theme=c46ece167b2fe61e15f5803d\u0026amp;signature=ea5cd231ce532446730427e7b1baeea1e6d048cd3e05dd7c1d7f59713e635e3a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/turris/UYm7mYboWneVSCYG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Turris Public API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#006cff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.turrisfi.com/api-reference/v1/surplus-lines-filings/get-filing\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v1/surplus-lines-filings/get-filing.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.turrisfi.com/#organization\",\"name\":\"Turris Public API\",\"url\":\"https://docs.turrisfi.com\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.turrisfi.com#website\",\"name\":\"Turris Public API\",\"url\":\"https://docs.turrisfi.com\",\"publisher\":{\"@id\":\"https://docs.turrisfi.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.turrisfi.com/api-reference/v1/surplus-lines-filings/get-filing#webpage\",\"url\":\"https://docs.turrisfi.com/api-reference/v1/surplus-lines-filings/get-filing\",\"name\":\"Surplus Lines Filing\",\"description\":\"Retrieve a single surplus lines filing by ID\",\"dateModified\":\"2026-11-12T22:37:41.373Z\",\"isPartOf\":{\"@id\":\"https://docs.turrisfi.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.turrisfi.com/api-reference/v1/surplus-lines-filings/get-filing#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.turrisfi.com/api-reference/v1/surplus-lines-filings/get-filing#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Surplus Lines Filings\",\"item\":\"https://docs.turrisfi.com/api-reference/v1/surplus-lines-filings/list-filings\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Surplus Lines Filing\",\"item\":\"https://docs.turrisfi.com/api-reference/v1/surplus-lines-filings/get-filing\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.turrisfi.com/api-reference/v1/surplus-lines-filings/get-filing#apireference\",\"headline\":\"Surplus Lines Filing\",\"name\":\"Surplus Lines Filing\",\"description\":\"Retrieve a single surplus lines filing by ID\",\"url\":\"https://docs.turrisfi.com/api-reference/v1/surplus-lines-filings/get-filing\",\"mainEntityOfPage\":{\"@id\":\"https://docs.turrisfi.com/api-reference/v1/surplus-lines-filings/get-filing#webpage\"},\"dateModified\":\"2026-11-12T22:37:41.373Z\",\"publisher\":{\"@id\":\"https://docs.turrisfi.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.turrisfi.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Turris Public API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Turris Public API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/v1/surplus-lines-filings/get-filing.md","siteName":"Turris Public API","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"Carrier \u0026 MGA API","icon":"building-columns","versions":[{"version":"v2","default":true,"pages":[{"title":"v2","href":"/api-reference/v2/surplus-lines-filings/get-filing"}]},{"version":"v1","tag":"Legacy","groups":[{"group":"Start Here","icon":"rocket","pages":[{"title":"The Carrier \u0026 MGA API","icon":"building-columns","href":"/guides/carrier-api"},{"title":"Migrating from v1 to v2","href":"/guides/migration-v1-to-v2"}]},{"group":"Shared Endpoints","icon":"key","pages":[{"title":"Health Check","openapi":"openapi/v1.json GET /v1/heartbeat","href":"/api-reference/v1/heartbeat/health-check"},{"title":"Get OAuth Token","openapi":"openapi/v1.json POST /v1/auth/jwt","href":"/api-reference/v1/authentication/get-oauth-token"},{"title":"Test OAuth","openapi":"openapi/v1.json GET /v1/auth/test-oauth","href":"/api-reference/v1/authentication/test-oauth"},{"title":"Test Restricted Access Token","openapi":"openapi/v1.json GET /v1/auth/test-restricted-access-token","href":"/api-reference/v1/authentication/test-restricted-access-token"}]},{"group":"Products","icon":"box","pages":[{"title":"List Products","openapi":"openapi/v1.json GET /v1/products","href":"/api-reference/v1/products/list-products"},{"title":"Get Product","openapi":"openapi/v1.json GET /v1/products/{productId}","href":"/api-reference/v1/products/get-product"}]},{"group":"Agencies You Appoint","icon":"building","pages":[{"title":"List Associations","openapi":"openapi/v1.json GET /v1/downstream-entity-associations","href":"/api-reference/v1/downstream-entity-associations/list-associations"},{"title":"Get Association","openapi":"openapi/v1.json GET /v1/downstream-entity-associations/{downstreamEntityAssociationId}","href":"/api-reference/v1/downstream-entity-associations/get-association"},{"title":"Get Sign-In URL","openapi":"openapi/v1.json GET /v1/downstream-entity-associations/{downstreamEntityAssociationId}/sign-in-url","href":"/api-reference/v1/downstream-entity-associations/get-sign-in-url"},{"title":"Invite Downstream Entity","openapi":"openapi/v1.json POST /v1/downstream-entity-associations/invite","href":"/api-reference/v1/downstream-entity-associations/invite"},{"title":"Add Downstream Entity","openapi":"openapi/v1.json POST /v1/downstream-entity-associations/add","href":"/api-reference/v1/downstream-entity-associations/add"},{"title":"Invite (Dangerously)","openapi":"openapi/v1.json POST /v1/downstream-entity-associations/dangerously-invite","deprecated":true,"href":"/api-reference/v1/downstream-entity-associations/dangerously-invite"},{"title":"Add (Dangerously)","openapi":"openapi/v1.json POST /v1/downstream-entity-associations/dangerously-add","deprecated":true,"href":"/api-reference/v1/downstream-entity-associations/dangerously-add"}]},{"group":"Contract Container Templates","icon":"file-contract","pages":[{"title":"List Contract Container Templates","openapi":"openapi/v1.json GET /v1/contract-container-templates","href":"/api-reference/v1/contract-container-templates/list"}]},{"group":"Agents","icon":"user","pages":[{"title":"List Agents","openapi":"openapi/v1.json GET /v1/agents","href":"/api-reference/v1/agents/list-agents"},{"title":"Get Agent","openapi":"openapi/v1.json GET /v1/agents/{agentId}","href":"/api-reference/v1/agents/get-agent"},{"title":"Create Agent","openapi":"openapi/v1.json POST /v1/agents","href":"/api-reference/v1/agents/create-agent"}]},{"group":"Contacts","icon":"address-book","pages":[{"title":"List Contacts","openapi":"openapi/v1.json GET /v1/contacts","href":"/api-reference/v1/contacts/list-contacts"},{"title":"Get Contact","openapi":"openapi/v1.json GET /v1/contacts/{contactId}","href":"/api-reference/v1/contacts/get-contact"}]},{"group":"Market Contacts","icon":"headset","pages":[{"title":"List Market Contacts","openapi":"openapi/v1.json GET /v1/market-contacts","href":"/api-reference/v1/market-contacts/list-market-contacts"}]},{"group":"Licenses","icon":"id-card","pages":[{"title":"Get Agent Licenses","openapi":"openapi/v1.json GET /v1/agents/{agentId}/licenses","href":"/api-reference/v1/licenses/agent-licenses"},{"title":"Get All Agent Licenses","openapi":"openapi/v1.json GET /v1/agents/licenses","href":"/api-reference/v1/licenses/all-agent-licenses"},{"title":"Get Downstream Entity Licenses","openapi":"openapi/v1.json GET /v1/downstream-entity-associations/{downstreamEntityAssociationId}/licenses","href":"/api-reference/v1/licenses/downstream-entity-licenses"},{"title":"Get All Downstream Entity Licenses","openapi":"openapi/v1.json GET /v1/downstream-entity-associations/licenses","href":"/api-reference/v1/licenses/all-downstream-entity-licenses"},{"title":"Get Downstream Entity Surplus Lines Licenses","openapi":"openapi/v1.json GET /v1/downstream-entity-associations/licenses/surplus-lines","href":"/api-reference/v1/licenses/surplus-lines"},{"title":"Get Downstream Entity Surplus Lines Licenses (Dangerously)","openapi":"openapi/v1.json GET /v1/downstream-entity-associations/licenses/dangerously-surplus-lines","deprecated":true,"href":"/api-reference/v1/licenses/dangerously-surplus-lines"}]},{"group":"Appointments","icon":"calendar","pages":[{"title":"Get Agent Appointments","openapi":"openapi/v1.json GET /v1/agents/{agentId}/appointments","href":"/api-reference/v1/appointments/agent-appointments"},{"title":"Get Downstream Entity Appointments","openapi":"openapi/v1.json GET /v1/downstream-entity-associations/{downstreamEntityAssociationId}/appointments","href":"/api-reference/v1/appointments/downstream-entity-appointments"}]},{"group":"Compliance Data Subscriptions","icon":"database","pages":[{"title":"Get Subscription Status","openapi":"openapi/v1.json GET /v1/compliance-data-subscriptions/{niprDataSubscriptionId}","href":"/api-reference/v1/compliance-data-subscriptions/get-status"},{"title":"Sync Downstream Entity","openapi":"openapi/v1.json POST /v1/downstream-entity-associations/{downstreamEntityAssociationId}/sync","href":"/api-reference/v1/compliance-data-subscriptions/sync-downstream-entity"},{"title":"Sync Agent","openapi":"openapi/v1.json POST /v1/agents/{agentId}/sync","href":"/api-reference/v1/compliance-data-subscriptions/sync-agent"}]},{"group":"Compliance Status","icon":"circle-check","pages":[{"title":"Get Agent Compliance Status","openapi":"openapi/v1.json GET /v1/agents/{agentId}/license-compliance-statuses","href":"/api-reference/v1/compliance-status/agent-compliance"},{"title":"Get Downstream Entity Compliance Status","openapi":"openapi/v1.json GET /v1/downstream-entity-associations/{downstreamEntityAssociationId}/license-compliance-statuses","href":"/api-reference/v1/compliance-status/downstream-entity-compliance"}]},{"group":"File Documents","icon":"file","pages":[{"title":"List Documents","openapi":"openapi/v1.json GET /v1/file-documents","href":"/api-reference/v1/file-documents/list-documents"},{"title":"Get Producer Agreement Templates","openapi":"openapi/v1.json GET /v1/file-documents","href":"/api-reference/v1/file-documents/get-producer-agreement-templates"},{"title":"Upload Document","openapi":"openapi/v1.json POST /v1/file-documents","href":"/api-reference/v1/file-documents/upload-document"}]},{"group":"Policy Ingestion","icon":"file-lines","pages":[{"title":"Policies","openapi":"openapi/v1.json GET /v1/policies","href":"/api-reference/v1/policies/list-policies"},{"title":"Policy","openapi":"openapi/v1.json GET /v1/policies/{policyId}","href":"/api-reference/v1/policies/get-policy"},{"title":"Create Policy","openapi":"openapi/v1.json POST /v1/policies","href":"/api-reference/v1/policies/create-policy"},{"title":"Update Policy","openapi":"openapi/v1.json PATCH /v1/policies/{policyId}","href":"/api-reference/v1/policies/update-policy"},{"title":"Delete Policy","openapi":"openapi/v1.json DELETE /v1/policies/{policyId}","href":"/api-reference/v1/policies/delete-policy"},{"title":"Upload Policy File","openapi":"openapi/v1.json POST /v1/policies/upload","href":"/api-reference/v1/policies/upload-policy-file"},{"title":"Uploading Status","openapi":"openapi/v1.json GET /v1/policies/uploads/{uploadId}","href":"/api-reference/v1/policies/get-upload-status"}]},{"group":"Policy Transactions","icon":"arrow-right-arrow-left","pages":[{"title":"Create Transaction","openapi":"openapi/v1.json POST /v1/policies/{policyId}/transactions","href":"/api-reference/v1/policy-transactions/create-transaction"},{"title":"List Transactions","openapi":"openapi/v1.json GET /v1/policies/{policyId}/transactions","href":"/api-reference/v1/policy-transactions/list-transactions"},{"title":"Get Transaction","openapi":"openapi/v1.json GET /v1/policies/{policyId}/transactions/{transactionId}","href":"/api-reference/v1/policy-transactions/get-transaction"},{"title":"Update Transaction","openapi":"openapi/v1.json PATCH /v1/policies/{policyId}/transactions/{transactionId}","href":"/api-reference/v1/policy-transactions/update-transaction"},{"title":"Delete Transaction","openapi":"openapi/v1.json DELETE /v1/policies/{policyId}/transactions/{transactionId}","href":"/api-reference/v1/policy-transactions/delete-transaction"}]},{"group":"Surplus Lines Filings","icon":"file-invoice-dollar","pages":[{"title":"Surplus Lines Filings","description":"List surplus lines filings belonging to the authenticated upstream entity","openapi":"openapi/v1.json GET /v1/surplus-lines-filings","href":"/api-reference/v1/surplus-lines-filings/list-filings"},{"title":"Surplus Lines Filing","openapi":"openapi/v1.json GET /v1/surplus-lines-filings/{filingId}","href":"/api-reference/v1/surplus-lines-filings/get-filing"}]},{"group":"Webhooks","icon":"bell","pages":[{"title":"List Webhooks","description":"List the webhooks registered by the authenticated upstream entity","openapi":"openapi/v1.json GET /v1/webhooks","href":"/api-reference/v1/webhooks/list-webhooks"},{"title":"Send Test Event","openapi":"openapi/v1.json POST /v1/webhooks/{webhookId}/test","href":"/api-reference/v1/webhooks/test-webhook"}]},{"group":"E\u0026O/Cyber Compliance","icon":"shield-check","pages":[{"title":"Get E\u0026O/Cyber Compliance","openapi":"openapi/v1.json GET /v1/downstream-entity-associations/{downstreamEntityAssociationId}/policy-compliance-statuses","href":"/api-reference/v1/eo-cyber-compliance/get-policy-compliance"}]},{"group":"Regulatory Actions","icon":"gavel","pages":[{"title":"Get Agent Regulatory Actions","openapi":"openapi/v1.json GET /v1/agents/{agentId}/regulatory-actions","href":"/api-reference/v1/regulatory-actions/agent-regulatory-actions"},{"title":"Get Downstream Entity Regulatory Actions","openapi":"openapi/v1.json GET /v1/downstream-entity-associations/{downstreamEntityAssociationId}/regulatory-actions","href":"/api-reference/v1/regulatory-actions/downstream-entity-regulatory-actions"}]},{"group":"Tools","icon":"wrench","pages":[{"title":"Validate NPNs","openapi":"openapi/v1.json POST /v1/npn-lookup","href":"/api-reference/v1/tools/validate-npns"}]}]}]},{"tab":"Agency API","icon":"building-user","pages":[{"title":"Agency API","href":"/guides/agency-api"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Surplus Lines Filing - Turris Public API","buildId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","deploymentId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-NXj-Rqjv.js","utils-m0thOP-_.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D13EKcfm.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema--XTdfsEb.js","snippetPresets-D3s4lmAH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-ChURybxL.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DL8CiXq2.js","shallow-DI2-YB2E.js","getApiPlaygroundDisplay-DxbW7b_y.js","CodeSnippet-CiNYS0pP.js","CodeSnippets-BT87bThu.js","Page-DSpdRuhM.js","getPastedJson-F_g_IrFQ.js","icon-CCIG5BAs.js","MethodPill-DY3E0jwx.js","DuplicateIcon-BN88xnEg.js","createIcon-VCCc5HO5.js","DynamicMarkdown-CaSwclgK.js","SectionHeading-DXV8nWhc.js","axios-vUo_bRtp.js","Markdown-CV32Re6G.js","clsx-5ydLOnhV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-pFDdfjRe.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BUGO5bPJ.js"]}