Get SOV layer analysis
curl --request GET \
--url https://api.sovfixer.com/api/v1/sov/{id}/layers \
--header 'Authorization: <api-key>'import requests
url = "https://api.sovfixer.com/api/v1/sov/{id}/layers"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.sovfixer.com/api/v1/sov/{id}/layers', 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.sovfixer.com/api/v1/sov/{id}/layers",
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: <api-key>"
],
]);
$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.sovfixer.com/api/v1/sov/{id}/layers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
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.sovfixer.com/api/v1/sov/{id}/layers")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sovfixer.com/api/v1/sov/{id}/layers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"tower": "standard",
"basis": "per_location",
"rows": [
{
"key": "primary_5",
"label": "Primary $5M",
"attach": 0,
"layer_limit": 5000000,
"count": 148,
"limits__total_limit_in_layer": 301200000,
"limits__total_limit_in_layer_pct": 62.44,
"filter": {
"limits__total_limit": {
"gt": 0
}
},
"links": {
"summary": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/summary?limits__total_limit[gt]=0&layer_attach=0&layer_limit=5000000",
"locations": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/locations?limits__total_limit[gt]=0&layer_attach=0&layer_limit=5000000"
}
},
{
"key": "x5_5",
"label": "$5M xs $5M",
"attach": 5000000,
"layer_limit": 5000000,
"count": 21,
"limits__total_limit_in_layer": 82400000,
"limits__total_limit_in_layer_pct": 17.08,
"filter": {
"limits__total_limit": {
"gt": 5000000
}
},
"links": {
"summary": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/summary?limits__total_limit[gt]=5000000&layer_attach=5000000&layer_limit=5000000",
"locations": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/locations?limits__total_limit[gt]=5000000&layer_attach=5000000&layer_limit=5000000"
}
},
{
"key": "x15_10",
"label": "$15M xs $10M",
"attach": 10000000,
"layer_limit": 15000000,
"count": 9,
"limits__total_limit_in_layer": 61750000,
"limits__total_limit_in_layer_pct": 12.8,
"filter": {
"limits__total_limit": {
"gt": 10000000
}
},
"links": {
"summary": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/summary?limits__total_limit[gt]=10000000&layer_attach=10000000&layer_limit=15000000",
"locations": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/locations?limits__total_limit[gt]=10000000&layer_attach=10000000&layer_limit=15000000"
}
},
{
"key": "x25_25",
"label": "$25M xs $25M",
"attach": 25000000,
"layer_limit": 25000000,
"count": 2,
"limits__total_limit_in_layer": 37000000,
"limits__total_limit_in_layer_pct": 7.67,
"filter": {
"limits__total_limit": {
"gt": 25000000
}
},
"links": {
"summary": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/summary?limits__total_limit[gt]=25000000&layer_attach=25000000&layer_limit=25000000",
"locations": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/locations?limits__total_limit[gt]=25000000&layer_attach=25000000&layer_limit=25000000"
}
},
{
"key": "x50_50",
"label": "$50M xs $50M",
"attach": 50000000,
"layer_limit": 50000000,
"count": 0,
"limits__total_limit_in_layer": 0,
"limits__total_limit_in_layer_pct": 0,
"filter": {
"limits__total_limit": {
"gt": 50000000
}
},
"links": {
"summary": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/summary?limits__total_limit[gt]=50000000&layer_attach=50000000&layer_limit=50000000",
"locations": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/locations?limits__total_limit[gt]=50000000&layer_attach=50000000&layer_limit=50000000"
}
},
{
"key": "x100_100",
"label": "$100M xs $100M",
"attach": 100000000,
"layer_limit": 100000000,
"count": 0,
"limits__total_limit_in_layer": 0,
"limits__total_limit_in_layer_pct": 0,
"filter": {
"limits__total_limit": {
"gt": 100000000
}
},
"links": {
"summary": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/summary?limits__total_limit[gt]=100000000&layer_attach=100000000&layer_limit=100000000",
"locations": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/locations?limits__total_limit[gt]=100000000&layer_attach=100000000&layer_limit=100000000"
}
},
{
"key": "x200_plus",
"label": "Excess $200M",
"attach": 200000000,
"layer_limit": null,
"count": 0,
"limits__total_limit_in_layer": 0,
"limits__total_limit_in_layer_pct": 0,
"filter": {
"limits__total_limit": {
"gt": 200000000
}
},
"links": {
"summary": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/summary?limits__total_limit[gt]=200000000&layer_attach=200000000",
"locations": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/locations?limits__total_limit[gt]=200000000&layer_attach=200000000"
}
}
]
}{
"pct_complete": 123,
"status": "NOT_INITIALIZED"
}{}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Analyze SOVs
Get SOV layer analysis
Get the TIV exposed to each layer of a tower for the locations of an SOV or portfolio that match the filters, using the standard tower or a custom one from layers. Layers apply to each location’s TIV separately, not to the policy aggregate: a location with 12MTIVcontributes5M to Primary 5M,5M to 5Mxs5M and 2Mto15M xs $10M. Every row carries filter and links to drill into the locations that reach the layer.
GET
/
api
/
v1
/
sov
/
{id}
/
layers
Get SOV layer analysis
curl --request GET \
--url https://api.sovfixer.com/api/v1/sov/{id}/layers \
--header 'Authorization: <api-key>'import requests
url = "https://api.sovfixer.com/api/v1/sov/{id}/layers"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.sovfixer.com/api/v1/sov/{id}/layers', 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.sovfixer.com/api/v1/sov/{id}/layers",
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: <api-key>"
],
]);
$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.sovfixer.com/api/v1/sov/{id}/layers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
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.sovfixer.com/api/v1/sov/{id}/layers")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sovfixer.com/api/v1/sov/{id}/layers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"tower": "standard",
"basis": "per_location",
"rows": [
{
"key": "primary_5",
"label": "Primary $5M",
"attach": 0,
"layer_limit": 5000000,
"count": 148,
"limits__total_limit_in_layer": 301200000,
"limits__total_limit_in_layer_pct": 62.44,
"filter": {
"limits__total_limit": {
"gt": 0
}
},
"links": {
"summary": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/summary?limits__total_limit[gt]=0&layer_attach=0&layer_limit=5000000",
"locations": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/locations?limits__total_limit[gt]=0&layer_attach=0&layer_limit=5000000"
}
},
{
"key": "x5_5",
"label": "$5M xs $5M",
"attach": 5000000,
"layer_limit": 5000000,
"count": 21,
"limits__total_limit_in_layer": 82400000,
"limits__total_limit_in_layer_pct": 17.08,
"filter": {
"limits__total_limit": {
"gt": 5000000
}
},
"links": {
"summary": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/summary?limits__total_limit[gt]=5000000&layer_attach=5000000&layer_limit=5000000",
"locations": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/locations?limits__total_limit[gt]=5000000&layer_attach=5000000&layer_limit=5000000"
}
},
{
"key": "x15_10",
"label": "$15M xs $10M",
"attach": 10000000,
"layer_limit": 15000000,
"count": 9,
"limits__total_limit_in_layer": 61750000,
"limits__total_limit_in_layer_pct": 12.8,
"filter": {
"limits__total_limit": {
"gt": 10000000
}
},
"links": {
"summary": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/summary?limits__total_limit[gt]=10000000&layer_attach=10000000&layer_limit=15000000",
"locations": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/locations?limits__total_limit[gt]=10000000&layer_attach=10000000&layer_limit=15000000"
}
},
{
"key": "x25_25",
"label": "$25M xs $25M",
"attach": 25000000,
"layer_limit": 25000000,
"count": 2,
"limits__total_limit_in_layer": 37000000,
"limits__total_limit_in_layer_pct": 7.67,
"filter": {
"limits__total_limit": {
"gt": 25000000
}
},
"links": {
"summary": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/summary?limits__total_limit[gt]=25000000&layer_attach=25000000&layer_limit=25000000",
"locations": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/locations?limits__total_limit[gt]=25000000&layer_attach=25000000&layer_limit=25000000"
}
},
{
"key": "x50_50",
"label": "$50M xs $50M",
"attach": 50000000,
"layer_limit": 50000000,
"count": 0,
"limits__total_limit_in_layer": 0,
"limits__total_limit_in_layer_pct": 0,
"filter": {
"limits__total_limit": {
"gt": 50000000
}
},
"links": {
"summary": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/summary?limits__total_limit[gt]=50000000&layer_attach=50000000&layer_limit=50000000",
"locations": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/locations?limits__total_limit[gt]=50000000&layer_attach=50000000&layer_limit=50000000"
}
},
{
"key": "x100_100",
"label": "$100M xs $100M",
"attach": 100000000,
"layer_limit": 100000000,
"count": 0,
"limits__total_limit_in_layer": 0,
"limits__total_limit_in_layer_pct": 0,
"filter": {
"limits__total_limit": {
"gt": 100000000
}
},
"links": {
"summary": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/summary?limits__total_limit[gt]=100000000&layer_attach=100000000&layer_limit=100000000",
"locations": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/locations?limits__total_limit[gt]=100000000&layer_attach=100000000&layer_limit=100000000"
}
},
{
"key": "x200_plus",
"label": "Excess $200M",
"attach": 200000000,
"layer_limit": null,
"count": 0,
"limits__total_limit_in_layer": 0,
"limits__total_limit_in_layer_pct": 0,
"filter": {
"limits__total_limit": {
"gt": 200000000
}
},
"links": {
"summary": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/summary?limits__total_limit[gt]=200000000&layer_attach=200000000",
"locations": "https://api.sovfixer.com/api/v1/sov/s-e-c2qahx/locations?limits__total_limit[gt]=200000000&layer_attach=200000000"
}
}
]
}{
"pct_complete": 123,
"status": "NOT_INITIALIZED"
}{}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Authorizations
tokenAuthcookieAuth
Token-based authentication with required prefix "Token"
Path Parameters
pingid, sovid, or portfolio id
Query Parameters
Location filters. Send each field as its own query parameter: field=value for an exact match, field[op]=value for an operator. state=TX&state=FL&const__bldg_year_built[gte]=1990 selects locations in TX or FL built in 1990 or later.
- Different fields: a location must match all of them.
- Repeating a field, or
[bins]with several bins: matches any of the values. - Several operators on one field: all must hold, forming a range.
N/Aas an exact value: matches locations missing the field.- A field takes an exact value,
[bins]or range operators, not a mix.
See SOV Data Analysis for every rule and examples. Location filters. Each key is a field: give a value for an exact match, or an object of operators.
Show child attributes
Show child attributes
Custom tower, one layer per value, as <limit>xs<attach> in whole currency units: 5000000xs0 is a primary $5M layer and xs200000000 is everything above $200M. Up to 20 layers. Cannot be combined with tower.
Required array length:
1 - 20 elementsPattern:
^(\d+)?xs(\d+)$Preset layer tower. standard is Primary $5M, $5M xs $5M, $15M xs $10M, $25M xs $25M, $50M xs $50M, $100M xs $100M and everything above $200M. Defaults to standard when layers is omitted.
standard- standard
Available options:
standard Response
Layer analysis for the matching locations.
per_location: each layer applies to every location's limits__total_limit separately, not to the aggregate.
per_location- per_location
Available options:
per_location One row per layer, in tower order.
Show child attributes
Show child attributes
standard for the preset tower, custom when layers was supplied.
standard- standardcustom- custom
Available options:
standard, custom ⌘I