Introduction

Welcome to the InsCipher API! You can utilize our API to ensure surplus lines taxes are calculated accurately, diligent forms are filled out correctly, and policy transaction and documents can be imported seamlessly.

Before You Get Started

This guide is for current InsCipher customers with an active account. If you're new, explore our sales or demo options here.

  1. Familiarize yourself with relevant API guides and schemas.
  2. Obtain an InsCipher API Key:
    • Connect clients: Settings > User List & Settings, select Agency Admin, and click 'Get a new API Key' under API & Batch Import Settings. One key serves all agencies in your account.
    • Filing Services clients: Settings > API > Edit > API Information, click 'Get a new API Key'.
    • Alternatively, contact customer support for assistance.
  3. Securely store your API key; it's visible only at generation. Losing it requires generating a new one, which inactivates the old key.

API Overview by Client Type

InsCipher primarily serves Connect and Filing Services clients, though standalone services like Tax Calculator or Diligent Forms API's are also available. Always use specific guides and schemas for your client type to prevent errors. Contact support for setup assistance.

Connect Clients

Connect® is an enterprise solution for surplus lines tax filing management. Its APIs streamline data syncing. Learn more:

API solutions for Connect® Users

Filing Services Clients

Filing Services® offers fully outsourced surplus lines reporting and tax payment. Its APIs streamline data syncing. Learn more:

API solutions for Filing Services® Users

Understanding InsCipher Terminology

Familiarize yourself with these common terms used in our documentation:

📘

Common Terms

  • Transaction / Filing: Policy data, invoice details, or individual policy filing.
  • Surplus Lines: Non-admitted policies written on the Excess and Surplus Lines market.
  • Documents: Policy documents (e.g., declination pages, full policy docs, state diligent effort forms) accompanying transactions or kept separately.
  • Line of Business: Refers to the Line of Business / Coverage Code associated with the policy.
  • Other Terms: Specific field names are defined in API guides.

Carefully review field name definitions for accurate mapping.


Rate Limits

InsCipher API requests have a rate limit of 10,000 per API key, per minute, for all public endpoints. Exceeding this limit results in a 429 Too many requests response; wait until the next minute for successful requests.

Errors

InsCipher uses standard HTTP response codes:

  • 2xx: Success
  • 4xx: Client-side error (invalid information)
  • 5xx: Server-side error