Surplus Lines API icon

Surplus Lines API

Calculate surplus lines taxes for all U.S. states. Supports current and historical rates with automatic fallback.

Actions2

Rate → Get Rate

AI-generated

Summary

Retrieve the current or historical surplus lines tax rate for a specified U.S. state, with automatic fallback to the current rate if the historical data is unavailable.

Inputs

  • State (required) — Select the U.S. state for which to look up the tax rate.
  • Date — Optional historical date (format YYYY-MM-DD) for the rate lookup. Leave empty to fetch the current rate. Automatically falls back to current rates if historical data is unavailable.

Output shape

a single JSON object containing surplus lines tax rate information for the specified state and date.

The response is a JSON object. If a historical date is specified but no data exists for that date, the current tax rate is returned instead. Errors include an error message in the JSON under an 'error' key.

Examples

Example 1: Get current surplus lines tax rate for Texas

State='Texas', Date='' (empty) returns the latest available tax rate for Texas.

Example 2: Get historical surplus lines tax rate for New York on 2022-01-01

State='New York', Date='2022-01-01' returns the rate for New York on or closest available to this date; falls back to current if none exists.

Links

Discussion