---
title: "API: KY - Admitted Premium, Surcharge, & Municipal Tax Calculations"
description: Instructions on how to get up-to-date Admitted insurance tax rates in the state of Kentucky via API through a JSON request.
---

[Skip to content](https://support.inscipher.com/migration/knowledge/admitted-api-ky#main-content)

English

Show submenu for translations

[Contact us](https://support.inscipher.com/migration/knowledge/kb-tickets/new) [Customer portal](https://support.inscipher.com/tickets-view)

![2023-03-02 08\_36\_43-InsCipher Logos 2023 - Google Drive.png\]](https://support.inscipher.com/hs-fs/hubfs/2023-03-02%2008_36_43-InsCipher%20Logos%202023%20-%20Google%20Drive.png?height=40&name=2023-03-02%2008_36_43-InsCipher%20Logos%202023%20-%20Google%20Drive.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Contact us](https://support.inscipher.com/migration/knowledge/kb-tickets/new)
- [Customer portal](https://support.inscipher.com/tickets-view)
- [https://surpluslines.inscipher.com](https://surpluslines.inscipher.com/)

[https://surpluslines.inscipher.com](https://surpluslines.inscipher.com/)

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [InsCipher Help Center](https://support.inscipher.com/migration/knowledge)
2. [Batch Import, APIs, and Integrations](https://support.inscipher.com/migration/knowledge/batch-import-apis-and-integrations)
3. [APIs](https://support.inscipher.com/migration/knowledge/batch-import-apis-and-integrations#apis)

# API: KY - Admitted Premium, Surcharge, & Municipal Tax Calculations

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

### Table of Contents

1. [Overview & Method](https://support.inscipher.com/migration/knowledge/admitted-api-ky#overview)
2. [URL Endpoint, Authentication, and API Keys](https://support.inscipher.com/migration/knowledge/admitted-api-ky#auth)
3. [JSON Sample Request](https://support.inscipher.com/migration/knowledge/admitted-api-ky#json_request) 
     1. [Description of Request Fields](https://support.inscipher.com/migration/knowledge/admitted-api-ky#req_desc)
4. [JSON Response](https://support.inscipher.com/migration/knowledge/admitted-api-ky#json_response) 
     1. [Description of Response Fields](https://support.inscipher.com/migration/knowledge/admitted-api-ky#response_desc)
5. [Version History](https://support.inscipher.com/migration/knowledge/admitted-api-ky#change)

### Overview & Method

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.](https://www.postman.com/downloads/) 

### Authentication and URL

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 [info@inscipher.com](mailto:info@inscipher.com) to learn how you can get your hands on a test API key.*

#### URL Endpoint:

[https://surpluslines.inscipher.com/api/tax-calculator/calculate-general-taxes.json?apikey=XXXXXXXXXXXXXXXXXXXXXXXXXXXXX](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). 

#### HTTP Method:

> POST

### 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

### Request Field Descriptions

| **Field Name** | **Description** | **Required Header?** | **Required Value?** | **Accepted Values** |
| --- | --- | --- | --- | --- |
| physical\_state | Currently, 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 info@inscipher.com and we can get you set up. The process for getting surplus line tax rates is very similar.* | Yes | Yes | "KY" STRING  |
| admitted | For getting Admitted/Premium tax rates, set this value to "1" | Yes | Yes | "1" INTEGAR |
| policy\_effective\_date | Policy effective date of the original policy. This is what determines the tax rate period as InsCipher stores historical tax rate records. | Yes | No If omitted, Today's Date will be Used | date (YYYY-MM-DD) |
| physical\_address |      The physical address of where the majority of the risk resides. | Yes | Yes | varchar (255) |
| physical\_city | The physical city of where the majority of the risk resides. | Yes | Yes | varchar (100) |
| physical\_zip\_code | The physical zip code of where the majority of the risk resides. | Yes | Yes | varchar (5)  |
| line\_of\_business | The type or line of business (aka coverage code).  - To get a list of LOB import codes, go **[here.](https://datastudio.google.com/u/0/reporting/88cfdf7f-3e3d-48b2-9c9e-0209f1d492d8/page/p_vw82sh8crc)** | Yes | Yes | string (10) |
| transaction\_type | The transaction or policy type - To get a list of all transaction-type import codes, go **[here.](https://datastudio.google.com/u/0/reporting/88cfdf7f-3e3d-48b2-9c9e-0209f1d492d8/page/p_hu3dx3gjqc)** | Yes | Yes | String (3) |
| premium | Gross premium on the policy | Yes | Yes | decimal (12,2) |
| agency\_fee | Total fees charged or retained by the brokerage includes fees such as policy fees, agency fees, filing fees, processing fees, etc. | Yes | No | decimal (12,2) |
| inspection\_fee | Total fees charged, mandated, or retained by the carrier include fees such as inspection fees, audit fees, carrier fees, underwriting fees, etc. | Yes | No | decimal (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 Name** | **Notes** |
| --- | --- |
| state | matches request value |
| admitted | matches request value |
| policy\_effective\_date | matches request value |
| premium | matches request value |
| agency\_fee | matches request value |
| inspection\_fee | matches request value |
| premium\_tax | Calculated Premium tax |
| municipal\_fee | Calculated 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\_fee | Calculated 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.](https://datastudio.google.com/u/0/reporting/88cfdf7f-3e3d-48b2-9c9e-0209f1d492d8/page/p_vw82sh8crc)**
- To get a list of all transaction-type import codes, go **[here.](https://datastudio.google.com/u/0/reporting/88cfdf7f-3e3d-48b2-9c9e-0209f1d492d8/page/p_hu3dx3gjqc)**

### **Change History**

| **Date** | **Description of Change** |
| --- | --- |
| 11/2/2023 |  Fixed municipal tax settings to allow for multi-LOB responses |
| 12/7/2022 | Article creation |

 

- [Internal - Compliance Processes & FAQs](https://support.inscipher.com/migration/knowledge/internal-compliance-processes-faqs)
- [Batch Import, APIs, and Integrations](https://support.inscipher.com/migration/knowledge/batch-import-apis-and-integrations#main-content)

    - [APIs](https://support.inscipher.com/migration/knowledge/batch-import-apis-and-integrations#apis)
    - [CSV Batch Imports](https://support.inscipher.com/migration/knowledge/batch-import-apis-and-integrations#csv-batch-imports)
    - [Integrations](https://support.inscipher.com/migration/knowledge/batch-import-apis-and-integrations#integrations)
    - [SSO Login Options](https://support.inscipher.com/migration/knowledge/batch-import-apis-and-integrations#sso-login-options)
    - [CSV Batch Import](https://support.inscipher.com/migration/knowledge/batch-import-apis-and-integrations#csv-batch-import)
    - [Document Imports](https://support.inscipher.com/migration/knowledge/batch-import-apis-and-integrations#document-imports)
- [Idaho - Surplus Lines Tax Filing and Payments](https://support.inscipher.com/migration/knowledge/idaho-surplus-lines-tax-filing-and-payments#main-content)

    - [Addressing Flag Filings](https://support.inscipher.com/migration/knowledge/idaho-surplus-lines-tax-filing-and-payments#addressing-flag-filings)
    - [Annual Premium Summary Reporting](https://support.inscipher.com/migration/knowledge/idaho-surplus-lines-tax-filing-and-payments#annual-premium-summary-reporting)
    - [Invoice Payments](https://support.inscipher.com/migration/knowledge/idaho-surplus-lines-tax-filing-and-payments#invoice-payments)
    - [Creating and Managing Users](https://support.inscipher.com/migration/knowledge/idaho-surplus-lines-tax-filing-and-payments#creating-and-managing-users)
    - [Adding Transactions/Filings Into the Broker Portal](https://support.inscipher.com/migration/knowledge/idaho-surplus-lines-tax-filing-and-payments#adding-transactions-filings-into-the-broker-portal)
    - [FAQs](https://support.inscipher.com/migration/knowledge/idaho-surplus-lines-tax-filing-and-payments#faqs)
- [Utah - Surplus Lines Tax Filing and Payments](https://support.inscipher.com/migration/knowledge/utah-surplus-lines-tax-filing-and-payments#main-content)

    - [Addressing Flag Filings](https://support.inscipher.com/migration/knowledge/utah-surplus-lines-tax-filing-and-payments#addressing-flag-filings)
    - [General Overview](https://support.inscipher.com/migration/knowledge/utah-surplus-lines-tax-filing-and-payments#general-overview)
    - [Invoice Payments](https://support.inscipher.com/migration/knowledge/utah-surplus-lines-tax-filing-and-payments#invoice-payments)
    - [Creating and Managing Users](https://support.inscipher.com/migration/knowledge/utah-surplus-lines-tax-filing-and-payments#creating-and-managing-users)
    - [Adding Transactions/Filings Into the Broker Portal](https://support.inscipher.com/migration/knowledge/utah-surplus-lines-tax-filing-and-payments#adding-transactions-filings-into-the-broker-portal)
- [Filing Services®- User Guides, Workflows, and FAQs](https://support.inscipher.com/migration/knowledge/filing-services-user-guides-workflows-and-faqs#main-content)

    - [Invoice Payments](https://support.inscipher.com/migration/knowledge/filing-services-user-guides-workflows-and-faqs#invoice-payments)
    - [Tax Exempt](https://support.inscipher.com/migration/knowledge/filing-services-user-guides-workflows-and-faqs#tax-exempt)
    - [State-Specific Requirements](https://support.inscipher.com/migration/knowledge/filing-services-user-guides-workflows-and-faqs#state-specific-requirements)
- [License Management Services](https://support.inscipher.com/migration/knowledge/license-management-services)
- [Not Seeing What You Need?](https://support.inscipher.com/migration/knowledge/not-seeing-what-you-need#main-content)

    - [Veracity RPGs](https://support.inscipher.com/migration/knowledge/not-seeing-what-you-need#veracity-rpgs)

[![Chill listening crop-3](https://support.inscipher.com/hs-fs/hubfs/2023%20Trans%20long%20dark.png?width=146&height=44&name=2023%20Trans%20long%20dark.png "Chill listening crop-3")](https://surpluslines.inscipher.com)

Surplus Lines Taxes. Simplified.

Copyright © 2026, InsCipher