> ## 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 Taxes and Fees

> A state's surplus lines tax, fees and taxable-base rules

Returns a state's surplus lines tax rates, what the taxable base includes, and any other fee the state charges.

## Working out the tax

Every rate in `rates` is a fraction of the taxable base: `0.0485` is 4.85%.

* **Taxable base** = gross premium + other taxable fees + the broker fee when `taxableBase.brokerFeesTaxed` is `true`
* **Surplus lines tax** = taxable base × `rates.slTaxRate`
* **Stamping fee** = taxable base × `rates.stampingFeeRate`
* **Fire marshal tax** = taxable base × `rates.fireMarshalTaxRate`

A rate of `0` means the state charges none. `taxableBase.taxableItems` and `taxableBase.brokerFeeRules` are the state's rules as written; read them, because they can add conditions the formula does not express.

## The other fee

> [!WARNING]
>
> `otherFee.label` is the authoritative description of the fee. `otherFee.rate` has no unit: it can be a fraction, a flat dollar amount, or `0` when the label alone describes the fee. It is not part of the formula above. Read the label before adding anything for this fee.

## What this does not cover

The response does not add up to a complete total for every state. The other fee sits outside the formula, and local taxes some states levy on top (Kentucky's municipal taxes, for example) are not included.

## 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",
    "updatedAt": "2026-10-20T14:02:11.000Z",
    "rates": { "slTaxRate": 0.0485, "stampingFeeRate": 0.0004, "fireMarshalTaxRate": 0 },
    "taxableBase": {
      "brokerFeesTaxed": true,
      "taxableItems": "Premium and all fees charged to the insured",
      "brokerFeeRules": "Broker fees are part of the taxable premium"
    },
    "otherFee": { "label": "", "rate": 0 }
  },
  "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 |
| `updatedAt` | string | ISO 8601 time of the last change to the state |
| `rates.slTaxRate` | number | Surplus lines tax, fraction of the taxable base |
| `rates.stampingFeeRate` | number | Stamping fee, fraction of the taxable base; `0` when none |
| `rates.fireMarshalTaxRate` | number | Fire marshal tax, fraction of the taxable base; `0` when none |
| `taxableBase.brokerFeesTaxed` | boolean | True when the broker fee is part of the taxable base |
| `taxableBase.taxableItems` | string | What the state taxes, as written |
| `taxableBase.brokerFeeRules` | string | The state's broker fee rules, as written |
| `otherFee.label` | string | Authoritative description of a fee outside the formula; empty when the state has none |
| `otherFee.rate` | number | No unit; see the warning above |

## 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}/tax-and-fees
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}/tax-and-fees:
    get:
      tags:
        - downstream/surplus-lines-states
      summary: Get a state's surplus lines taxes and fees
      description: >-
        A state's surplus lines tax, stamping fee and fire marshal tax as
        fractions of the taxable base, what that base includes, and any other
        fee the state charges. otherFee.label is the authoritative description
        of that fee; otherFee.rate has no unit and is not part of the rate
        formula. The response does not add up to a complete total for every
        state. Returns 404 for a state Turris keeps no requirements for.
      operationId: DownstreamSurplusLinesStatesController_getTaxAndFees_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 taxes and fees
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/SurplusLinesStateTaxAndFeesResponse'
                  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:
    SurplusLinesStateTaxAndFeesResponse:
      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
        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'
        rates:
          description: Rates that multiply the taxable base
          allOf:
            - $ref: '#/components/schemas/SurplusLinesStateRatesResponse'
        taxableBase:
          description: What the taxable base includes
          allOf:
            - $ref: '#/components/schemas/SurplusLinesStateTaxableBaseResponse'
        otherFee:
          description: A state fee outside the rate formula
          allOf:
            - $ref: '#/components/schemas/SurplusLinesStateOtherFeeResponse'
      required:
        - stateCode
        - name
        - updatedAt
        - rates
        - taxableBase
        - otherFee
    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
    SurplusLinesStateRatesResponse:
      type: object
      properties:
        slTaxRate:
          type: number
          description: >-
            Surplus lines tax, as a fraction of the taxable base: 0.0485 is
            4.85%
          example: 0.0485
        stampingFeeRate:
          type: number
          description: >-
            Stamping fee, as a fraction of the taxable base; 0 when the state
            has none
          example: 0.0018
        fireMarshalTaxRate:
          type: number
          description: >-
            Fire marshal tax, as a fraction of the taxable base; 0 when the
            state has none
          example: 0
      required:
        - slTaxRate
        - stampingFeeRate
        - fireMarshalTaxRate
    SurplusLinesStateTaxableBaseResponse:
      type: object
      properties:
        brokerFeesTaxed:
          type: boolean
          description: True when the broker fee is part of the taxable base
          example: true
        taxableItems:
          type: string
          description: What the state taxes, as written
          example: Premium and all fees charged to the insured
        brokerFeeRules:
          type: string
          description: The state's broker fee rules, as written
          example: Broker fees are part of the taxable premium
      required:
        - brokerFeesTaxed
        - taxableItems
        - brokerFeeRules
    SurplusLinesStateOtherFeeResponse:
      type: object
      properties:
        label:
          type: string
          description: >-
            The authoritative description of the fee; empty string when the
            state has none
          example: $12 filing fee (flat)
        rate:
          type: number
          description: >-
            Has no unit: a fraction, a flat dollar amount, or 0 when label alone
            describes the fee. It is not part of the rate formula; read label
            before using it.
          example: 12
      required:
        - label
        - rate
  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 Taxes and Fees](https://docs.turrisfi.com/api-reference/v2/surplus-lines-states/get-tax-and-fees.md)
- [List Surplus Lines States](https://docs.turrisfi.com/api-reference/v2/downstream/surplus-lines-states/list-states.md)
- [Changelog](https://docs.turrisfi.com/changelog.md)


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