> ## Documentation Index
> Fetch the complete documentation index at: https://docs.turrisfi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get State Requirements

> A state's filing deadline and the documents a surplus lines filing there needs

Returns a state's filing deadline and the documents a surplus lines filing in that state needs from you, grouped by category and sorted by `order`.

## Matching a filing's checklist

`sourceTaskId` is the same value a filing opened in this state carries as `sourceTaskId` on the matching checklist item, and `sourceCategoryId` the same as the item's `sourceCategoryId`. Use them to prepare documents before you [open a filing](https://docs.turrisfi.com/api-reference/v2/downstream/surplus-lines-filings/open-filing.md) and to recognise the items on it afterwards. Both ids stay the same when Turris edits the state's requirements.

`sourceCategoryId` is repeated on every item, so `categories.flatMap((category) => category.items)` keeps it.

## Blank forms

Where the state provides a form, the requirement lists it in `templateFiles` as metadata: name, type, size, label and upload time. Get a short-lived link for one with [Get a Download URL for a State Template File](https://docs.turrisfi.com/api-reference/v2/downstream/surplus-lines-states/get-template-file-download-url.md), passing its `id` as `templateFileId`.

## What is not listed

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

## Response Shape

> [!NOTE]
>
> All successful responses are wrapped in the standard response envelope. See [Request/Response Conventions](https://docs.turrisfi.com/guides/request-response.md).

```json theme={null}
{
  "data": {
    "stateCode": "TX",
    "name": "Texas",
    "deadline": "60 days after the policy effective date",
    "updatedAt": "2026-10-20T14:02:11.000Z",
    "categories": [
      {
        "sourceCategoryId": "6650a1b2c3d4e5f6a7b8c9d0",
        "name": "Documentation",
        "order": 0,
        "items": [
          {
            "sourceCategoryId": "6650a1b2c3d4e5f6a7b8c9d0",
            "sourceTaskId": "6650a1b2c3d4e5f6a7b8c9d1",
            "label": "Signed application",
            "required": true,
            "order": 0,
            "templateFiles": [
              {
                "id": "6650a1b2c3d4e5f6a7b8c9d2",
                "fileName": "texas-sl-application.pdf",
                "mimeType": "application/pdf",
                "fileSize": 248310,
                "description": "Blank form",
                "uploadedAt": "2026-10-01T09:00:00.000Z"
              }
            ]
          },
          {
            "sourceCategoryId": "6650a1b2c3d4e5f6a7b8c9d0",
            "sourceTaskId": "6650a1b2c3d4e5f6a7b8c9d3",
            "label": "Prior carrier letter",
            "required": false,
            "order": 1,
            "templateFiles": []
          }
        ]
      }
    ]
  },
  "requestId": "abcd1234",
  "timestamp": "2026-10-22T12:00:00.000Z"
}
```

### Response Fields

| Field | Type | Description |
| - | - | - |
| `stateCode` | string | US state or territory code |
| `name` | string | State name |
| `deadline` | string | The state's filing deadline, as written |
| `updatedAt` | string | ISO 8601 time of the last change to the state; moves on any change, including ones no response shows |
| `categories[].sourceCategoryId` | string | Identifier of the category |
| `categories[].name` | string | Category name |
| `categories[].order` | number | Display order |
| `categories[].items[].sourceCategoryId` | string | The category's id, repeated |
| `categories[].items[].sourceTaskId` | string | Identifier of the requirement; matches `sourceTaskId` on a filing's checklist item in this state |
| `categories[].items[].label` | string | What the requirement asks for |
| `categories[].items[].required` | boolean | True when a filing cannot complete without it |
| `categories[].items[].order` | number | Display order within the category |
| `categories[].items[].templateFiles[]` | array | Blank forms: `id`, `fileName`, `mimeType`, `fileSize` (bytes), `description` (label, empty when none), `uploadedAt` |

## Error Scenarios

### Bad Request (400)

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

### State Not Found (404)

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

### Unauthorized (401)

Missing or invalid authentication token. See [Authentication](https://docs.turrisfi.com/authentication.md).

### Forbidden (403)

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

### Too Many Requests (429)

More than 120 requests in 60 seconds from your organization. See [Rate Limiting](https://docs.turrisfi.com/guides/rate-limiting.md).


## OpenAPI

````yaml openapi/v2.json GET /v2/downstream/surplus-lines-states/{stateCode}/requirements
openapi: 3.0.0
info:
  title: Turris Public API
  description: API for managing insurance compliance data
  version: 2.0.0
  contact: {}
servers:
  - url: https://public.api.live.turrisfi.com
    description: Production
  - url: https://public.api.sandbox.turrisfi.com
    description: Sandbox
security:
  - bearer: []
  - restricted-access-token: []
tags:
  - name: auth
    description: Shared. Serves either organization category, so no persona applies.
    x-organization-category: null
  - name: downstream/actions-required
    description: >-
      Agency surface. Requires a credential whose organization category is
      downstreamEntity.
    x-organization-category: downstreamEntity
  - name: downstream/appointments
    description: >-
      Agency surface. Requires a credential whose organization category is
      downstreamEntity.
    x-organization-category: downstreamEntity
  - name: downstream/carriers
    description: >-
      Agency surface. Requires a credential whose organization category is
      downstreamEntity.
    x-organization-category: downstreamEntity
  - name: downstream/compliance-configs
    description: >-
      Agency surface. Requires a credential whose organization category is
      downstreamEntity.
    x-organization-category: downstreamEntity
  - name: downstream/contacts
    description: >-
      Agency surface. Requires a credential whose organization category is
      downstreamEntity.
    x-organization-category: downstreamEntity
  - name: downstream/corporate-registrations
    description: >-
      Agency surface. Requires a credential whose organization category is
      downstreamEntity.
    x-organization-category: downstreamEntity
  - name: downstream/documents
    description: >-
      Agency surface. Requires a credential whose organization category is
      downstreamEntity.
    x-organization-category: downstreamEntity
  - name: downstream/entities
    description: >-
      Agency surface. Requires a credential whose organization category is
      downstreamEntity.
    x-organization-category: downstreamEntity
  - name: downstream/license-overview
    description: >-
      Agency surface. Requires a credential whose organization category is
      downstreamEntity.
    x-organization-category: downstreamEntity
  - name: downstream/license-requests
    description: >-
      Agency surface. Requires a credential whose organization category is
      downstreamEntity.
    x-organization-category: downstreamEntity
  - name: downstream/licenses
    description: >-
      Agency surface. Requires a credential whose organization category is
      downstreamEntity.
    x-organization-category: downstreamEntity
  - name: downstream/markets
    description: >-
      Agency surface. Requires a credential whose organization category is
      downstreamEntity.
    x-organization-category: downstreamEntity
  - name: downstream/producers
    description: >-
      Agency surface. Requires a credential whose organization category is
      downstreamEntity.
    x-organization-category: downstreamEntity
  - name: downstream/surplus-lines-filings
    description: >-
      Agency surface. Requires a credential whose organization category is
      downstreamEntity.
    x-organization-category: downstreamEntity
  - name: downstream/surplus-lines-states
    description: >-
      Agency surface. Requires a credential whose organization category is
      downstreamEntity.
    x-organization-category: downstreamEntity
  - name: heartbeat
    description: Shared. Serves either organization category, so no persona applies.
    x-organization-category: null
  - name: upstream/agents
    description: >-
      Carrier and MGA surface. Requires a credential whose organization category
      is upstreamEntity.
    x-organization-category: upstreamEntity
  - name: upstream/agents-license-compliance
    description: >-
      Carrier and MGA surface. Requires a credential whose organization category
      is upstreamEntity.
    x-organization-category: upstreamEntity
  - name: upstream/appointment-requests
    description: >-
      Carrier and MGA surface. Requires a credential whose organization category
      is upstreamEntity.
    x-organization-category: upstreamEntity
  - name: upstream/carriers
    description: >-
      Carrier and MGA surface. Requires a credential whose organization category
      is upstreamEntity.
    x-organization-category: upstreamEntity
  - name: upstream/compliance-data-subscriptions
    description: >-
      Carrier and MGA surface. Requires a credential whose organization category
      is upstreamEntity.
    x-organization-category: upstreamEntity
  - name: upstream/contacts
    description: >-
      Carrier and MGA surface. Requires a credential whose organization category
      is upstreamEntity.
    x-organization-category: upstreamEntity
  - name: upstream/contract-container-templates
    description: >-
      Carrier and MGA surface. Requires a credential whose organization category
      is upstreamEntity.
    x-organization-category: upstreamEntity
  - name: upstream/diligent-effort-requests
    description: >-
      Carrier and MGA surface. Requires a credential whose organization category
      is upstreamEntity.
    x-organization-category: upstreamEntity
  - name: upstream/downstream-entity-associations
    description: >-
      Carrier and MGA surface. Requires a credential whose organization category
      is upstreamEntity.
    x-organization-category: upstreamEntity
  - name: upstream/file-documents
    description: >-
      Carrier and MGA surface. Requires a credential whose organization category
      is upstreamEntity.
    x-organization-category: upstreamEntity
  - name: upstream/market-contacts
    description: >-
      Carrier and MGA surface. Requires a credential whose organization category
      is upstreamEntity.
    x-organization-category: upstreamEntity
  - name: upstream/npn-lookup
    description: >-
      Carrier and MGA surface. Requires a credential whose organization category
      is upstreamEntity.
    x-organization-category: upstreamEntity
  - name: upstream/policies
    description: >-
      Carrier and MGA surface. Requires a credential whose organization category
      is upstreamEntity.
    x-organization-category: upstreamEntity
  - name: upstream/products
    description: >-
      Carrier and MGA surface. Requires a credential whose organization category
      is upstreamEntity.
    x-organization-category: upstreamEntity
  - name: upstream/surplus-lines-filings
    description: >-
      Carrier and MGA surface. Requires a credential whose organization category
      is upstreamEntity.
    x-organization-category: upstreamEntity
  - name: upstream/surplus-lines-states
    description: >-
      Carrier and MGA surface. Requires a credential whose organization category
      is upstreamEntity.
    x-organization-category: upstreamEntity
  - name: upstream/termination-requests
    description: >-
      Carrier and MGA surface. Requires a credential whose organization category
      is upstreamEntity.
    x-organization-category: upstreamEntity
  - name: upstream/webhooks
    description: >-
      Carrier and MGA surface. Requires a credential whose organization category
      is upstreamEntity.
    x-organization-category: upstreamEntity
paths:
  /v2/downstream/surplus-lines-states/{stateCode}/requirements:
    get:
      tags:
        - downstream/surplus-lines-states
      summary: Get a state's surplus lines requirements
      description: >-
        A state's filing deadline and the documents a surplus lines filing there
        needs from you, grouped by category. Blank forms are listed as metadata;
        get a short-lived link for one with Get a Download URL for a State
        Template File. Items Turris keeps internal are never listed.
        sourceTaskId equals the sourceTaskId of the same item on a filing opened
        in this state. Returns 404 for a state Turris keeps no requirements for.
      operationId: DownstreamSurplusLinesStatesController_getRequirements_v2
      parameters:
        - name: stateCode
          required: true
          in: path
          description: US state or territory code
          schema:
            example: TX
            type: string
            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
      responses:
        '200':
          description: The state's surplus lines requirements
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/SurplusLinesStateRequirementsResponse'
                  requestId:
                    type: string
                    description: Unique request identifier
                    example: dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8
                  timestamp:
                    type: string
                    description: Response timestamp
                    example: '2025-11-12T20:49:03.293Z'
                required:
                  - data
                  - requestId
                  - timestamp
        '400':
          description: stateCode is not a US state or territory code
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
        '401':
          description: Invalid or missing auth token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
        '403':
          description: >-
            Your organization is not entitled to the public API, or does not
            have the Surplus-Lines Filing feature. Also 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:
                $ref: '#/components/schemas/ErrorResponseDto'
        '404':
          description: Turris keeps no surplus lines requirements for this state
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
        '429':
          description: >-
            Rate limit exceeded. Like every read on the Agency API, this
            endpoint allows 120 requests per 60 seconds per organization. Wait
            the number of seconds in the Retry-After header, then retry. Also
            returned when this credential passes the API-wide limit of 1000
            requests per 10 seconds, counted across every endpoint.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
          headers:
            Retry-After:
              description: >-
                Seconds to wait before retrying. Sent when a rate limit refused
                the request.
              schema:
                type: integer
components:
  schemas:
    SurplusLinesStateRequirementsResponse:
      type: object
      properties:
        stateCode:
          type: string
          description: US state or territory code
          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: TX
        name:
          type: string
          description: State name
          example: Texas
        deadline:
          type: string
          description: The state's filing deadline, as written
          example: 60 days after the policy effective date
        updatedAt:
          type: string
          description: >-
            ISO 8601 timestamp of the last change to this state; moves on any
            change, including ones no response shows
          example: '2026-03-15T09:30:00.000Z'
        categories:
          description: >-
            The documents a filing in this state needs from you, grouped and
            sorted by order. Turris-internal items are never listed.
          type: array
          items:
            $ref: '#/components/schemas/SurplusLinesStateRequirementCategoryResponse'
      required:
        - stateCode
        - name
        - deadline
        - updatedAt
        - categories
    ErrorResponseDto:
      type: object
      properties:
        statusCode:
          type: number
          description: HTTP status code
        requestId:
          type: string
          description: Unique request identifier for debugging
        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
            - contract_already_signed
            - 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
            - online_signing_in_progress
            - 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
        errorMessage:
          description: Array of error messages
          type: array
          items:
            type: string
        timestamp:
          type: string
          description: ISO timestamp when the error occurred
        details:
          type: object
          description: Additional error context
      required:
        - statusCode
        - requestId
        - errorType
        - errorMessage
        - timestamp
    SurplusLinesStateRequirementCategoryResponse:
      type: object
      properties:
        sourceCategoryId:
          type: string
          description: Identifier of the category
          example: 6650a1b2c3d4e5f6a7b8c9d0
        name:
          type: string
          description: Category name
          example: Documentation
        order:
          type: number
          description: Display order among the categories
          example: 0
        items:
          description: Requirements in this category, sorted by order
          type: array
          items:
            $ref: '#/components/schemas/SurplusLinesStateRequirementItemResponse'
      required:
        - sourceCategoryId
        - name
        - order
        - items
    SurplusLinesStateRequirementItemResponse:
      type: object
      properties:
        sourceCategoryId:
          type: string
          description: >-
            Identifier of the category this requirement belongs to, repeated
            here so it survives categories.flatMap((category) => category.items)
          example: 6650a1b2c3d4e5f6a7b8c9d0
        sourceTaskId:
          type: string
          description: >-
            Identifier of this requirement. A filing opened in this state
            carries the same value as sourceTaskId on the matching checklist
            item, so it joins what the state requires to what a filing asks you
            for. It survives edits to the state's requirements.
          example: 6650a1b2c3d4e5f6a7b8c9d1
        label:
          type: string
          description: What the requirement asks for
          example: Signed application
        required:
          type: boolean
          description: True when a filing cannot complete without it
          example: true
        order:
          type: number
          description: Display order within its category
          example: 0
        templateFiles:
          description: >-
            Blank forms supplied for this requirement, metadata only; fetch a
            link per file with its id
          type: array
          items:
            $ref: '#/components/schemas/SurplusLinesStateTemplateFileResponse'
      required:
        - sourceCategoryId
        - sourceTaskId
        - label
        - required
        - order
        - templateFiles
    SurplusLinesStateTemplateFileResponse:
      type: object
      properties:
        id:
          type: string
          description: >-
            Identifier of the template file. Pass it as templateFileId to Get a
            Download URL for a State Template File. A filing opened in this
            state shows the same id on this file in its checklist.
          example: 6650a1b2c3d4e5f6a7b8c9d2
        fileName:
          type: string
          description: Original file name; the download saves under it
          example: texas-sl-application.pdf
        mimeType:
          type: string
          description: MIME type of the file
          example: application/pdf
        fileSize:
          type: number
          description: File size in bytes
          example: 248310
        description:
          type: string
          description: >-
            Label of the file, for example "Blank form"; empty string when none
            was set
          example: Blank form
        uploadedAt:
          type: string
          description: ISO 8601 timestamp when Turris uploaded the file
          example: '2026-03-01T10:00:00.000Z'
      required:
        - id
        - fileName
        - mimeType
        - fileSize
        - description
        - uploadedAt
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http
    restricted-access-token:
      type: apiKey
      in: header
      name: x-restricted-access-token
      description: >-
        Alternative authentication: Restricted access token (if not using Bearer
        token)

````

## Related topics

- [Get State Requirements](https://docs.turrisfi.com/api-reference/v2/surplus-lines-states/get-requirements.md)
- [Get a Download URL for a State Template File](https://docs.turrisfi.com/api-reference/v2/downstream/surplus-lines-states/get-template-file-download-url.md)
- [List Surplus Lines States](https://docs.turrisfi.com/api-reference/v2/downstream/surplus-lines-states/list-states.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.