curl --request GET \
--url https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/financials \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/financials"
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}/financials', 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}/financials",
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}/financials"
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}/financials")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/financials")
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{
"carrier": {
"id": "<string>",
"name": "<string>"
},
"year": 123,
"coverage": "complete",
"companies": [
{
"naicCompanyCode": "<string>",
"premium": {
"direct": 123,
"assumedAffiliated": 123,
"assumedUnaffiliated": 123,
"cededAffiliated": 123,
"cededUnaffiliated": 123,
"net": 123
},
"underwriting": {
"premiumWritten": 123,
"premiumEarned": 123,
"dividendsToPolicyholders": 123,
"lossesIncurred": 123,
"defenseAndCostContainmentIncurred": 123,
"adjustingAndOtherExpensesIncurred": 123,
"unpaidLosses": 123,
"unearnedPremiumReserve": 123,
"commissionsAndBrokerageExpense": 123,
"taxesLicensesAndFees": 123,
"otherAcquisitionExpenses": 123,
"generalExpensesIncurred": 123,
"otherIncome": 123,
"pretaxProfit": 123
},
"sources": [
{
"exhibit": "<string>",
"statementYear": 5949,
"line": "35"
}
]
}
]
}{
"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"
}{
"error": "<string>",
"code": "<string>",
"details": [
{
"location": "path",
"path": [
"<string>"
],
"code": "required",
"message": "<string>"
}
],
"requestId": "<string>",
"dataset": "naic"
}Get a carrier’s annual financial totals
Read reported all-lines premium and underwriting totals from Part 1B and IEE Part 3 for one statement year. Requires the organization’s NAIC dataset grant after acceptance of the NAIC terms; checked before carrier lookup. Whole US dollars; IEE amounts are scaled from thousands. Null is unavailable, zero is reported zero, and negative values are preserved. Source NAIC companies remain separate, including codes without totals. Missing exhibits stay null with partial coverage; no older-year fallback, sums of detail lines, calculated ratios, gross premium or rankings. No balance sheet, solvency, product or MGA financials. The latest loaded values can change on reimport; this is not restatement history. One complete or partial financials document counts as one billed row: 0.03persuccessfulcall(0.02 request + $0.01 snapshot). Failed reads are not charged; repeated successful reads are charged again. Read-only; private, no-store. At most 200 source-company sections; oversized carrier identities return 409 without truncation. Use state-results for jurisdiction and line observations.
curl --request GET \
--url https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/financials \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/financials"
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}/financials', 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}/financials",
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}/financials"
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}/financials")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/financials")
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{
"carrier": {
"id": "<string>",
"name": "<string>"
},
"year": 123,
"coverage": "complete",
"companies": [
{
"naicCompanyCode": "<string>",
"premium": {
"direct": 123,
"assumedAffiliated": 123,
"assumedUnaffiliated": 123,
"cededAffiliated": 123,
"cededUnaffiliated": 123,
"net": 123
},
"underwriting": {
"premiumWritten": 123,
"premiumEarned": 123,
"dividendsToPolicyholders": 123,
"lossesIncurred": 123,
"defenseAndCostContainmentIncurred": 123,
"adjustingAndOtherExpensesIncurred": 123,
"unpaidLosses": 123,
"unearnedPremiumReserve": 123,
"commissionsAndBrokerageExpense": 123,
"taxesLicensesAndFees": 123,
"otherAcquisitionExpenses": 123,
"generalExpensesIncurred": 123,
"otherIncome": 123,
"pretaxProfit": 123
},
"sources": [
{
"exhibit": "<string>",
"statementYear": 5949,
"line": "35"
}
]
}
]
}{
"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"
}{
"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 NAIC company codes and naic: codes are also accepted.
1 - 100Query Parameters
Statement year. Omit for the latest year with a reported line-35 total in either Part 1B or IEE Part 3 across this carrier’s source NAIC codes. All sections use that same year; missing sections never fall back to an older year.
^\d{4}$Response
One annual document with explicit exhibit coverage.
Show child attributes
Show child attributes
Complete means both total rows exist for every source company, not that all fields or all statement exhibits are available. Partial means at least one total row is absent.
complete, partial Embedded source-company sections, ordered by NAIC code. Includes codes with missing totals. These are parts of one annual document, not a paginated resource collection.
200Show child attributes
Show child attributes