curl --request GET \
--url https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results/{id}"
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/{id}', 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/{id}",
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/{id}"
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/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results/{id}")
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{
"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
}
]
}{
"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 state result
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. Use the ID returned by listCarrierStateResults under the same carrier. Reads the current loaded value of the source observation, not an immutable revision. A removed observation or wrong carrier returns 404. Accepts no query parameters. Read-only; private, no-store.
curl --request GET \
--url https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results/{id}"
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/{id}', 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/{id}",
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/{id}"
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/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.effectiveai.app/api/v2/insurance/carriers/{carrierId}/state-results/{id}")
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{
"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
}
]
}{
"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 - 100200Response
One state observation, with the same representation as the list.
Opaque observation ID. Pass unchanged to the item GET under the same carrier. Identifies the source observation, not an immutable value/version.
Show child attributes
Show child attributes
Five-digit source NAIC company code, preserved separately from the managed carrier identity.
1900 <= x <= 9999Show child attributes
Show child attributes
Whole US dollars. Null is unavailable; zero is reported zero. Negative amounts are preserved.
Whole US dollars. Null is unavailable; zero is reported zero. Negative amounts are preserved.
Whole US dollars. Null is unavailable; zero is reported zero. Negative amounts are preserved.
Whole US dollars. Null is unavailable; zero is reported zero. Negative amounts are preserved.
Whole US dollars. Null is unavailable; zero is reported zero. Negative amounts are preserved.
Whole US dollars. Null is unavailable; zero is reported zero. Negative amounts are preserved.
Whole US dollars. Null is unavailable; zero is reported zero. Negative amounts are preserved.
Whole US dollars. Null is unavailable; zero is reported zero. Negative amounts are preserved.
Whole US dollars. Null is unavailable; zero is reported zero. Negative amounts are preserved.
Whole US dollars. Null is unavailable; zero is reported zero. Negative amounts are preserved.
Whole US dollars. Null is unavailable; zero is reported zero. Negative amounts are preserved.
Whole US dollars. Null is unavailable; zero is reported zero. Negative amounts are preserved.
Show child attributes
Show child attributes