get_premium_sample

Free sample of the premium data: statewide all-lines monthly premium and policy-count series for a state, latest 13 months. Line/county/insurer detail, full history, and cross-state comparison are paid tools.

Parameters1

state

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "state": {
      "default": "FL",
      "type": "string",
      "minLength": 1
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_lines

List the coverage line taxonomy (source codes, names, normalized categories) available for a state. Free.

Parameters1

state

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "state"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_coverage

Report which states, date ranges, and granularities (month/quarter/year) have data available. Free.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_eligibility_sample

Free sample of the NAIC IID (Quarterly Listing of Alien Insurers) eligibility roster: a few alien companies and Lloyd's syndicates, plus the latest edition's additions/removals. Free.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_premium

Time series of E&S/surplus lines premium and policy counts for a state, optionally by coverage line, date range, and granularity. $0.10 per query. Mirrors GET /v1/premium.

Parameters6

state	string	required
line	string	optional
county	string	optional
from	string	optional
to	string	optional
granularity	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "minLength": 1
    },
    "line": {
      "default": "all",
      "type": "string",
      "minLength": 1
    },
    "county": {
      "type": "string",
      "minLength": 1
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
    },
    "granularity": {
      "default": "month",
      "type": "string",
      "enum": [
        "month",
        "quarter",
        "year"
      ]
    }
  },
  "required": [
    "state"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_summary

Year-over-year premium and policy count summary for a state and year. $0.10 per query. Mirrors GET /v1/premium/summary.

Parameters2

state	string	required
year	integer	required

Raw schema

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "minLength": 1
    },
    "year": {
      "type": "integer",
      "minimum": 1900,
      "maximum": 2100
    }
  },
  "required": [
    "state",
    "year"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_top_insurers

Top insurers by E&S/surplus lines premium for a state and period (month or year). $0.10 per query. Mirrors GET /v1/insurers.

Parameters2

state	string	required
period	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "minLength": 1
    },
    "period": {
      "type": "string",
      "pattern": "^\\d{4}(-(0[1-9]|1[0-2]))?$"
    }
  },
  "required": [
    "state",
    "period"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

compare_states

Compare premium/policy count series across multiple states side-by-side. $0.50 per query. Mirrors GET /v1/compare.

Parameters5

states	array	required
line	string	optional
from	string	optional
to	string	optional
granularity	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "states": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "line": {
      "default": "all",
      "type": "string",
      "minLength": 1
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
    },
    "granularity": {
      "default": "month",
      "type": "string",
      "enum": [
        "month",
        "quarter",
        "year"
      ]
    }
  },
  "required": [
    "states"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_eligibility

Look up NAIC IID (Quarterly Listing of Alien Insurers) surplus-lines eligibility -- nationwide under NRRA -- for an insurer by name or alien ID, or list the current roster with recent additions/removals. $0.10 per query. Mirrors GET /v1/eligibility.

Parameters5

insurer	string	optional
state	string	optional
changes_since	string	optional
entity_type	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "insurer": {
      "type": "string",
      "minLength": 1
    },
    "state": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$"
    },
    "changes_since": {
      "type": "string",
      "pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
    },
    "entity_type": {
      "type": "string",
      "enum": [
        "alien_company",
        "lloyds_syndicate"
      ]
    },
    "limit": {
      "default": 100,
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

QueryLines

get_premium_sample

list_lines

get_coverage

get_eligibility_sample

get_premium

get_summary

get_top_insurers

compare_states

check_eligibility

Install

Remote endpoint