curl --request GET \
--url https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"year": 5949,
"resolvedLines": [
"<string>"
],
"stateResults": [
{
"id": "<string>",
"carrier": {
"id": "<string>",
"name": "<string>"
},
"naicCompanyCode": "<string>",
"year": 5949,
"state": "<string>",
"line": {
"code": "<string>",
"name": "<string>",
"family": "allied-lines",
"scheme": "statement"
},
"directPremiumWritten": 123,
"directPremiumEarned": 123,
"dividendsToPolicyholders": 123,
"directUnearnedPremiumReserve": 123,
"directLossesPaid": 123,
"directLossesIncurred": 123,
"directLossesUnpaid": 123,
"defenseAndCostContainmentPaid": 123,
"defenseAndCostContainmentIncurred": 123,
"defenseAndCostContainmentUnpaid": 123,
"commissionsAndBrokerageExpense": 123,
"taxesLicensesAndFees": 123,
"sources": [
{
"exhibit": "<string>",
"statementYear": 5949
}
]
}
],
"nextCursor": "<string>",
"sources": [
{
"exhibit": "<string>",
"statementYear": 5949
}
]
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic"
}List a carrier’s state results
Requires the organization’s NAIC dataset grant after acceptance of the NAIC terms. The grant is checked before carrier lookup on every request. Each successful request costs 0.02plus0.01 per returned observation. Failed requests are not charged; repeated successful reads are charged again. Read stored direct premiums, losses and expenses from the state Exhibit of Premiums and Losses. Whole US dollars; null is not zero; negative values are preserved. Rows remain separate for each source NAIC code, year, jurisdiction and statement line. Line 35 is a total and line 34 is aggregate write-ins; do not add totals to their components. Write-in details and footnotes are not included. Ordered by source NAIC code, jurisdiction, then line code (lexically). Live keyset paging is not a snapshot; reimports can change values. Repeat the original filters and limit with nextCursor; omitted year remains pinned. Cursors expire after 24 hours and are bound to the caller, carrier identifiers and query. Read an item at GET /insurance/carriers//state-results/ using stateResults[].id. Read-only; private, no-store.
curl --request GET \
--url https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"year": 5949,
"resolvedLines": [
"<string>"
],
"stateResults": [
{
"id": "<string>",
"carrier": {
"id": "<string>",
"name": "<string>"
},
"naicCompanyCode": "<string>",
"year": 5949,
"state": "<string>",
"line": {
"code": "<string>",
"name": "<string>",
"family": "allied-lines",
"scheme": "statement"
},
"directPremiumWritten": 123,
"directPremiumEarned": 123,
"dividendsToPolicyholders": 123,
"directUnearnedPremiumReserve": 123,
"directLossesPaid": 123,
"directLossesIncurred": 123,
"directLossesUnpaid": 123,
"defenseAndCostContainmentPaid": 123,
"defenseAndCostContainmentIncurred": 123,
"defenseAndCostContainmentUnpaid": 123,
"commissionsAndBrokerageExpense": 123,
"taxesLicensesAndFees": 123,
"sources": [
{
"exhibit": "<string>",
"statementYear": 5949
}
]
}
],
"nextCursor": "<string>",
"sources": [
{
"exhibit": "<string>",
"statementYear": 5949
}
]
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic"
}Authorizations
Effective API key. Send Authorization: Bearer sk-eai-...
Path Parameters
Managed carrier_ ID or bare checked code. Legacy five-digit NAIC codes and naic: codes are also accepted.
1 - 100Query Parameters
Statement year. Omit for this carrier’s latest loaded state exhibit; continuation pins that year.
^\d{4}$Two-letter jurisdiction code. Omit to traverse all reported jurisdictions.
^[A-Za-z]{2}$Exact statement line code, such as 17.1. Validated against the loaded line catalog and known exhibit eras. Cannot be combined with lineFamily.
^\d{2}(?:\.\d{1,2})?$Resolve a family to its source lines for the selected year. Returns separate observations, without aggregating them.
allied-lines, cmp, group-ah, other-ah, inland-marine, ppa-liability, commercial-auto-liability, auto-physical-damage Maximum number of items to return (1-200).
1 <= x <= 200nextCursor from the previous page.
Response
One page of state observations.
Resolved statement year, fixed for this traversal.
1900 <= x <= 9999Exact source codes selected by line/lineFamily; empty means no line filter.
Show child attributes
Show child attributes
Cursor for the next page, or null on the last page.
Show child attributes
Show child attributes