Admitted KY Insurance Tax Rates

Instructions on how to get up-to-date Admitted insurance tax rates in the state of Kentucky via API through a JSON request.

Introduction

This API allows your management system to quickly query and receive state and municipal tax rates in the state of Kentucky. You will also get the municipal taxing jurisdiction calculated and returned for you as well.

👍

TIP:

There are different methods or approaches to retrieving tax calculations using InsCipher's Access REST API. If you need a quick solution to test out an import and do not currently have one, consider utilizing Postman.

Request Method

Authentication

HTTP Method: POST

Users are authenticated using an API key, which is provided by your InsCipher implementation specialist. The API key is typically around 40 characters.

API Key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

❗️

If you are a prospective client, please contact [email protected]to learn how to obtain an API key.

Endpoint URL

https://surpluslines.inscipher.com/api/tax-calculator/calculate-general-taxes.json?apikey=XXXXXXXXXXXXXXXXXXXXXXXXXXXXX

📘

Note:

This URL is the same URL used to calculate admitted and non-admitted (surplus lines taxes).

🚧

Before Getting Started:

InsCipher utilizes data tables outside of the documentation for every request to provide the most up to date requirements for your integration. Depending on your configuration, you may need to reference the following tables, which will be mentioned further down in the documentation.

Feel free to open these in a new window or bookmark for future use:

JSON Request Sample

{
"admitted": 1,
"physical_state" : "KY",
"physical_address": "1110 Sparks Rd",
"physical_city" : "Lexington",
"physical_zip_code": "40505",
"line_of_business" : "1014",
"policy_effective_date" : "2023-01-01",
"transaction_type" : "PN",
"premium" : 1000.55,
"agency_fee" : 100,
"inspection_fee" : 200
}

📘

Note:

For policies with multiple lines of business, use separate requests for the premium associated with each LOB


Field Descriptions and Requirements (REQUEST)

Field NameDescriptionRequired Header?Required Value?Accepted Values
physical_stateCurrently, we only provide admitted tax rates for Kentucky so set this value to be "KY".

If you wish to get surplus lines tax rates in all 50 states + US territories and DC, contact [email protected] and we can get you set up. The process for getting surplus line tax rates is very similar.
YesYes"KY"

STRING
admittedFor getting Admitted/Premium tax rates, set this value to "1"YesYes"1"

INTEGAR
policy_effective_datePolicy effective date of the original policy. This is what determines the tax rate period as InsCipher stores historical tax rate records.YesNo

If omitted, Today's Date will be Used
date

(YYYY-MM-DD)
physical_addressThe physical address of where the majority of the risk resides.YesYesvarchar (255)
physical_cityThe physical city of where the majority of the risk resides.YesYesvarchar (100)
physical_zip_codeThe physical zip code of where the majority of the risk resides.YesYesvarchar (5)
line_of_businessThe type or line of business (aka coverage code).
To get a list of LOB import codes, go here.
YesYesstring (10)
transaction_typeThe transaction or policy type

To get a list of all transaction-type import codes, go here.
YesYesString (3)
premiumGross premium on the policyYesYesdecimal (12,2)
agency_feeTotal fees charged or retained by the brokerage includes fees such as policy fees, agency fees, filing fees, processing fees, etc.YesNodecimal (12,2)
inspection_feeTotal fees charged, mandated, or retained by the carrier include fees such as inspection fees, audit fees, carrier fees, underwriting fees, etc.YesNodecimal (12,2)

JSON Response Sample

{
    "state": "KY",
    "admitted": 1,
    "policy_effective_date": "2023-01-01",
    "premium": 1000.55,
    "inspection_fee": 200,
    "agency_fee": 100,
    "premium_tax": 26.01,
    "municipal_fee": "65.03",
    "municipal_tax_settings": [
        {
            "municipal_tax_setting": {
                "municipality_name": "Lexington-Fayette",
                "line_category": "inland_marine"
            }
        }
    ],
    "stamping_fee": 23.41
}

Response Field Descriptions

Field NameNotes
statematches request value
admittedmatches request value
policy_effective_datematches request value
premiummatches request value
agency_feematches request value
inspection_feematches request value
premium_taxCalculated Premium tax
municipal_feeCalculated Municipal tax (i.e. Local Government Premium Tax)
municipal_tax_settings

municipal_tax_setting

` municipality_name

line_category`
Two Values Returned:

1. Calculated local government jurisdiction name (i.e. the municipality name)

2. Line category for which the municipal taxes are based (used in LGPT reporting)
stamping_feeCalculated Surcharge tax

Policy Type Code and LOB Code Mapping

Kentucky does tax differently, on the municipal level, based on the line of business/coverage code used on the policy.

  • To get a list of LOB import codes, go here.
  • To get a list of all transaction-type import codes, go here.