Bind a Quoted Submission
curl --request PUT \
--url https://api.coverwhale.dev/v1/bind/{displayId} \
--header 'Accept: <accept>' \
--header 'AccessToken: <api-key>' \
--header 'Content-Type: <content-type>' \
--data '
{
"coverage": {
"includeAPD": "Y",
"includeAL": "Y",
"includeTGL": "Y",
"includeNTL": "Y",
"includeMTC": "Y",
"brokerFeeAL": 10,
"brokerFeeAPD": 10,
"brokerFeeMTC": 10,
"brokerFeeTGL": 10,
"brokerFeeNTL": 10,
"optInCWFinancing": "Y",
"electTRIA": "N",
"effectiveDate": "02/25/2026"
},
"bindingMethod": {
"signFirst": "N",
"retailAgentEmail": "agent@example.com",
"insuredEmail": "insured@example.com",
"insuredFullName": "John Doe",
"electronicSignature": "Y",
"acknowledgeMissingOwnerDriverWarning": true
},
"shippingAddress": {
"dashcam_shipping_address": "insured",
"street": "4310 W Jefferson Blvd",
"city": "Los Angeles",
"state": "CA",
"zip": "90016",
"county": "Los Angeles"
},
"diligentSearch": {
"insurer1Name": "Progressive Commercial",
"insurer1Naic": "24260",
"insurer1OnlineDeclination": "N",
"insurer1Website": "https://www.progressivecommercial.com",
"insurer1ContactName": "Jane Underwriter",
"insurer1ContactPhoneEmail": "jane@example.com / 555-123-4567",
"insurer2Name": "Great West Casualty",
"insurer2Naic": "11371",
"insurer2OnlineDeclination": "Y",
"insurer2Website": "https://www.gwccnet.com",
"insurer2ContactName": "Bob Broker",
"insurer2ContactPhoneEmail": "bob@example.com / 555-987-6543",
"insurer3Name": "Canal Insurance",
"insurer3Naic": "10464",
"insurer3OnlineDeclination": "N",
"insurer3Website": "https://www.canalinsurance.com",
"insurer3ContactName": "Sam Producer",
"insurer3ContactPhoneEmail": "sam@example.com / 555-555-0100"
},
"acknowledgeMissingOwnerDriverWarning": true,
"acknowledgeQuoteRevision": true,
"quoteRevisionKey": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
}
'import requests
url = "https://api.coverwhale.dev/v1/bind/{displayId}"
payload = {
"coverage": {
"includeAPD": "Y",
"includeAL": "Y",
"includeTGL": "Y",
"includeNTL": "Y",
"includeMTC": "Y",
"brokerFeeAL": 10,
"brokerFeeAPD": 10,
"brokerFeeMTC": 10,
"brokerFeeTGL": 10,
"brokerFeeNTL": 10,
"optInCWFinancing": "Y",
"electTRIA": "N",
"effectiveDate": "02/25/2026"
},
"bindingMethod": {
"signFirst": "N",
"retailAgentEmail": "agent@example.com",
"insuredEmail": "insured@example.com",
"insuredFullName": "John Doe",
"electronicSignature": "Y",
"acknowledgeMissingOwnerDriverWarning": True
},
"shippingAddress": {
"dashcam_shipping_address": "insured",
"street": "4310 W Jefferson Blvd",
"city": "Los Angeles",
"state": "CA",
"zip": "90016",
"county": "Los Angeles"
},
"diligentSearch": {
"insurer1Name": "Progressive Commercial",
"insurer1Naic": "24260",
"insurer1OnlineDeclination": "N",
"insurer1Website": "https://www.progressivecommercial.com",
"insurer1ContactName": "Jane Underwriter",
"insurer1ContactPhoneEmail": "jane@example.com / 555-123-4567",
"insurer2Name": "Great West Casualty",
"insurer2Naic": "11371",
"insurer2OnlineDeclination": "Y",
"insurer2Website": "https://www.gwccnet.com",
"insurer2ContactName": "Bob Broker",
"insurer2ContactPhoneEmail": "bob@example.com / 555-987-6543",
"insurer3Name": "Canal Insurance",
"insurer3Naic": "10464",
"insurer3OnlineDeclination": "N",
"insurer3Website": "https://www.canalinsurance.com",
"insurer3ContactName": "Sam Producer",
"insurer3ContactPhoneEmail": "sam@example.com / 555-555-0100"
},
"acknowledgeMissingOwnerDriverWarning": True,
"acknowledgeQuoteRevision": True,
"quoteRevisionKey": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
}
headers = {
"Content-Type": "<content-type>",
"Accept": "<accept>",
"AccessToken": "<api-key>"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'Content-Type': '<content-type>', Accept: '<accept>', AccessToken: '<api-key>'},
body: JSON.stringify({
coverage: {
includeAPD: 'Y',
includeAL: 'Y',
includeTGL: 'Y',
includeNTL: 'Y',
includeMTC: 'Y',
brokerFeeAL: 10,
brokerFeeAPD: 10,
brokerFeeMTC: 10,
brokerFeeTGL: 10,
brokerFeeNTL: 10,
optInCWFinancing: 'Y',
electTRIA: 'N',
effectiveDate: '02/25/2026'
},
bindingMethod: {
signFirst: 'N',
retailAgentEmail: 'agent@example.com',
insuredEmail: 'insured@example.com',
insuredFullName: 'John Doe',
electronicSignature: 'Y',
acknowledgeMissingOwnerDriverWarning: true
},
shippingAddress: {
dashcam_shipping_address: 'insured',
street: '4310 W Jefferson Blvd',
city: 'Los Angeles',
state: 'CA',
zip: '90016',
county: 'Los Angeles'
},
diligentSearch: {
insurer1Name: 'Progressive Commercial',
insurer1Naic: '24260',
insurer1OnlineDeclination: 'N',
insurer1Website: 'https://www.progressivecommercial.com',
insurer1ContactName: 'Jane Underwriter',
insurer1ContactPhoneEmail: 'jane@example.com / 555-123-4567',
insurer2Name: 'Great West Casualty',
insurer2Naic: '11371',
insurer2OnlineDeclination: 'Y',
insurer2Website: 'https://www.gwccnet.com',
insurer2ContactName: 'Bob Broker',
insurer2ContactPhoneEmail: 'bob@example.com / 555-987-6543',
insurer3Name: 'Canal Insurance',
insurer3Naic: '10464',
insurer3OnlineDeclination: 'N',
insurer3Website: 'https://www.canalinsurance.com',
insurer3ContactName: 'Sam Producer',
insurer3ContactPhoneEmail: 'sam@example.com / 555-555-0100'
},
acknowledgeMissingOwnerDriverWarning: true,
acknowledgeQuoteRevision: true,
quoteRevisionKey: 'aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa'
})
};
fetch('https://api.coverwhale.dev/v1/bind/{displayId}', 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.coverwhale.dev/v1/bind/{displayId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'coverage' => [
'includeAPD' => 'Y',
'includeAL' => 'Y',
'includeTGL' => 'Y',
'includeNTL' => 'Y',
'includeMTC' => 'Y',
'brokerFeeAL' => 10,
'brokerFeeAPD' => 10,
'brokerFeeMTC' => 10,
'brokerFeeTGL' => 10,
'brokerFeeNTL' => 10,
'optInCWFinancing' => 'Y',
'electTRIA' => 'N',
'effectiveDate' => '02/25/2026'
],
'bindingMethod' => [
'signFirst' => 'N',
'retailAgentEmail' => 'agent@example.com',
'insuredEmail' => 'insured@example.com',
'insuredFullName' => 'John Doe',
'electronicSignature' => 'Y',
'acknowledgeMissingOwnerDriverWarning' => true
],
'shippingAddress' => [
'dashcam_shipping_address' => 'insured',
'street' => '4310 W Jefferson Blvd',
'city' => 'Los Angeles',
'state' => 'CA',
'zip' => '90016',
'county' => 'Los Angeles'
],
'diligentSearch' => [
'insurer1Name' => 'Progressive Commercial',
'insurer1Naic' => '24260',
'insurer1OnlineDeclination' => 'N',
'insurer1Website' => 'https://www.progressivecommercial.com',
'insurer1ContactName' => 'Jane Underwriter',
'insurer1ContactPhoneEmail' => 'jane@example.com / 555-123-4567',
'insurer2Name' => 'Great West Casualty',
'insurer2Naic' => '11371',
'insurer2OnlineDeclination' => 'Y',
'insurer2Website' => 'https://www.gwccnet.com',
'insurer2ContactName' => 'Bob Broker',
'insurer2ContactPhoneEmail' => 'bob@example.com / 555-987-6543',
'insurer3Name' => 'Canal Insurance',
'insurer3Naic' => '10464',
'insurer3OnlineDeclination' => 'N',
'insurer3Website' => 'https://www.canalinsurance.com',
'insurer3ContactName' => 'Sam Producer',
'insurer3ContactPhoneEmail' => 'sam@example.com / 555-555-0100'
],
'acknowledgeMissingOwnerDriverWarning' => true,
'acknowledgeQuoteRevision' => true,
'quoteRevisionKey' => 'aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa'
]),
CURLOPT_HTTPHEADER => [
"Accept: <accept>",
"AccessToken: <api-key>",
"Content-Type: <content-type>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.coverwhale.dev/v1/bind/{displayId}"
payload := strings.NewReader("{\n \"coverage\": {\n \"includeAPD\": \"Y\",\n \"includeAL\": \"Y\",\n \"includeTGL\": \"Y\",\n \"includeNTL\": \"Y\",\n \"includeMTC\": \"Y\",\n \"brokerFeeAL\": 10,\n \"brokerFeeAPD\": 10,\n \"brokerFeeMTC\": 10,\n \"brokerFeeTGL\": 10,\n \"brokerFeeNTL\": 10,\n \"optInCWFinancing\": \"Y\",\n \"electTRIA\": \"N\",\n \"effectiveDate\": \"02/25/2026\"\n },\n \"bindingMethod\": {\n \"signFirst\": \"N\",\n \"retailAgentEmail\": \"agent@example.com\",\n \"insuredEmail\": \"insured@example.com\",\n \"insuredFullName\": \"John Doe\",\n \"electronicSignature\": \"Y\",\n \"acknowledgeMissingOwnerDriverWarning\": true\n },\n \"shippingAddress\": {\n \"dashcam_shipping_address\": \"insured\",\n \"street\": \"4310 W Jefferson Blvd\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"zip\": \"90016\",\n \"county\": \"Los Angeles\"\n },\n \"diligentSearch\": {\n \"insurer1Name\": \"Progressive Commercial\",\n \"insurer1Naic\": \"24260\",\n \"insurer1OnlineDeclination\": \"N\",\n \"insurer1Website\": \"https://www.progressivecommercial.com\",\n \"insurer1ContactName\": \"Jane Underwriter\",\n \"insurer1ContactPhoneEmail\": \"jane@example.com / 555-123-4567\",\n \"insurer2Name\": \"Great West Casualty\",\n \"insurer2Naic\": \"11371\",\n \"insurer2OnlineDeclination\": \"Y\",\n \"insurer2Website\": \"https://www.gwccnet.com\",\n \"insurer2ContactName\": \"Bob Broker\",\n \"insurer2ContactPhoneEmail\": \"bob@example.com / 555-987-6543\",\n \"insurer3Name\": \"Canal Insurance\",\n \"insurer3Naic\": \"10464\",\n \"insurer3OnlineDeclination\": \"N\",\n \"insurer3Website\": \"https://www.canalinsurance.com\",\n \"insurer3ContactName\": \"Sam Producer\",\n \"insurer3ContactPhoneEmail\": \"sam@example.com / 555-555-0100\"\n },\n \"acknowledgeMissingOwnerDriverWarning\": true,\n \"acknowledgeQuoteRevision\": true,\n \"quoteRevisionKey\": \"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Content-Type", "<content-type>")
req.Header.Add("Accept", "<accept>")
req.Header.Add("AccessToken", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.coverwhale.dev/v1/bind/{displayId}")
.header("Content-Type", "<content-type>")
.header("Accept", "<accept>")
.header("AccessToken", "<api-key>")
.body("{\n \"coverage\": {\n \"includeAPD\": \"Y\",\n \"includeAL\": \"Y\",\n \"includeTGL\": \"Y\",\n \"includeNTL\": \"Y\",\n \"includeMTC\": \"Y\",\n \"brokerFeeAL\": 10,\n \"brokerFeeAPD\": 10,\n \"brokerFeeMTC\": 10,\n \"brokerFeeTGL\": 10,\n \"brokerFeeNTL\": 10,\n \"optInCWFinancing\": \"Y\",\n \"electTRIA\": \"N\",\n \"effectiveDate\": \"02/25/2026\"\n },\n \"bindingMethod\": {\n \"signFirst\": \"N\",\n \"retailAgentEmail\": \"agent@example.com\",\n \"insuredEmail\": \"insured@example.com\",\n \"insuredFullName\": \"John Doe\",\n \"electronicSignature\": \"Y\",\n \"acknowledgeMissingOwnerDriverWarning\": true\n },\n \"shippingAddress\": {\n \"dashcam_shipping_address\": \"insured\",\n \"street\": \"4310 W Jefferson Blvd\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"zip\": \"90016\",\n \"county\": \"Los Angeles\"\n },\n \"diligentSearch\": {\n \"insurer1Name\": \"Progressive Commercial\",\n \"insurer1Naic\": \"24260\",\n \"insurer1OnlineDeclination\": \"N\",\n \"insurer1Website\": \"https://www.progressivecommercial.com\",\n \"insurer1ContactName\": \"Jane Underwriter\",\n \"insurer1ContactPhoneEmail\": \"jane@example.com / 555-123-4567\",\n \"insurer2Name\": \"Great West Casualty\",\n \"insurer2Naic\": \"11371\",\n \"insurer2OnlineDeclination\": \"Y\",\n \"insurer2Website\": \"https://www.gwccnet.com\",\n \"insurer2ContactName\": \"Bob Broker\",\n \"insurer2ContactPhoneEmail\": \"bob@example.com / 555-987-6543\",\n \"insurer3Name\": \"Canal Insurance\",\n \"insurer3Naic\": \"10464\",\n \"insurer3OnlineDeclination\": \"N\",\n \"insurer3Website\": \"https://www.canalinsurance.com\",\n \"insurer3ContactName\": \"Sam Producer\",\n \"insurer3ContactPhoneEmail\": \"sam@example.com / 555-555-0100\"\n },\n \"acknowledgeMissingOwnerDriverWarning\": true,\n \"acknowledgeQuoteRevision\": true,\n \"quoteRevisionKey\": \"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.coverwhale.dev/v1/bind/{displayId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Content-Type"] = '<content-type>'
request["Accept"] = '<accept>'
request["AccessToken"] = '<api-key>'
request.body = "{\n \"coverage\": {\n \"includeAPD\": \"Y\",\n \"includeAL\": \"Y\",\n \"includeTGL\": \"Y\",\n \"includeNTL\": \"Y\",\n \"includeMTC\": \"Y\",\n \"brokerFeeAL\": 10,\n \"brokerFeeAPD\": 10,\n \"brokerFeeMTC\": 10,\n \"brokerFeeTGL\": 10,\n \"brokerFeeNTL\": 10,\n \"optInCWFinancing\": \"Y\",\n \"electTRIA\": \"N\",\n \"effectiveDate\": \"02/25/2026\"\n },\n \"bindingMethod\": {\n \"signFirst\": \"N\",\n \"retailAgentEmail\": \"agent@example.com\",\n \"insuredEmail\": \"insured@example.com\",\n \"insuredFullName\": \"John Doe\",\n \"electronicSignature\": \"Y\",\n \"acknowledgeMissingOwnerDriverWarning\": true\n },\n \"shippingAddress\": {\n \"dashcam_shipping_address\": \"insured\",\n \"street\": \"4310 W Jefferson Blvd\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"zip\": \"90016\",\n \"county\": \"Los Angeles\"\n },\n \"diligentSearch\": {\n \"insurer1Name\": \"Progressive Commercial\",\n \"insurer1Naic\": \"24260\",\n \"insurer1OnlineDeclination\": \"N\",\n \"insurer1Website\": \"https://www.progressivecommercial.com\",\n \"insurer1ContactName\": \"Jane Underwriter\",\n \"insurer1ContactPhoneEmail\": \"jane@example.com / 555-123-4567\",\n \"insurer2Name\": \"Great West Casualty\",\n \"insurer2Naic\": \"11371\",\n \"insurer2OnlineDeclination\": \"Y\",\n \"insurer2Website\": \"https://www.gwccnet.com\",\n \"insurer2ContactName\": \"Bob Broker\",\n \"insurer2ContactPhoneEmail\": \"bob@example.com / 555-987-6543\",\n \"insurer3Name\": \"Canal Insurance\",\n \"insurer3Naic\": \"10464\",\n \"insurer3OnlineDeclination\": \"N\",\n \"insurer3Website\": \"https://www.canalinsurance.com\",\n \"insurer3ContactName\": \"Sam Producer\",\n \"insurer3ContactPhoneEmail\": \"sam@example.com / 555-555-0100\"\n },\n \"acknowledgeMissingOwnerDriverWarning\": true,\n \"acknowledgeQuoteRevision\": true,\n \"quoteRevisionKey\": \"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa\"\n}"
response = http.request(request)
puts response.read_body{
"status": "bind requested",
"submission_number": "264206519582",
"coverages": {},
"premium_finance": {
"provider": "capital",
"down_payment": 4250,
"monthly_payment": 1583.33,
"effective_apr": 0.0925,
"number_of_payments": 9,
"total_of_payments": 14250
}
}{
"status": "quote refresh started",
"reason_code": "quote_refresh_started",
"error": "The effective date changed, so a complete refreshed quote and document set is being generated.",
"quote_refresh": {
"revision_key": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"batch_id": "<string>",
"effective_date_before": "2023-12-25",
"effective_date_after": "2023-12-25",
"years_business_before": 123,
"months_business_before": 123,
"years_business_after": 123,
"months_business_after": 123
}
}{
"status": "failed",
"error": "Submission status must be quoted"
}{
"status": "failed",
"error": "An owner who is also a driver was not found on this submission.",
"warning_type": "missing_owner_driver",
"acknowledgement_required": true
}Binding
Bind a Quoted Submission
Submit a bind request for a quoted submission. The submission must be in ‘Quoted’ status.
PUT
/
bind
/
{displayId}
Bind a Quoted Submission
curl --request PUT \
--url https://api.coverwhale.dev/v1/bind/{displayId} \
--header 'Accept: <accept>' \
--header 'AccessToken: <api-key>' \
--header 'Content-Type: <content-type>' \
--data '
{
"coverage": {
"includeAPD": "Y",
"includeAL": "Y",
"includeTGL": "Y",
"includeNTL": "Y",
"includeMTC": "Y",
"brokerFeeAL": 10,
"brokerFeeAPD": 10,
"brokerFeeMTC": 10,
"brokerFeeTGL": 10,
"brokerFeeNTL": 10,
"optInCWFinancing": "Y",
"electTRIA": "N",
"effectiveDate": "02/25/2026"
},
"bindingMethod": {
"signFirst": "N",
"retailAgentEmail": "agent@example.com",
"insuredEmail": "insured@example.com",
"insuredFullName": "John Doe",
"electronicSignature": "Y",
"acknowledgeMissingOwnerDriverWarning": true
},
"shippingAddress": {
"dashcam_shipping_address": "insured",
"street": "4310 W Jefferson Blvd",
"city": "Los Angeles",
"state": "CA",
"zip": "90016",
"county": "Los Angeles"
},
"diligentSearch": {
"insurer1Name": "Progressive Commercial",
"insurer1Naic": "24260",
"insurer1OnlineDeclination": "N",
"insurer1Website": "https://www.progressivecommercial.com",
"insurer1ContactName": "Jane Underwriter",
"insurer1ContactPhoneEmail": "jane@example.com / 555-123-4567",
"insurer2Name": "Great West Casualty",
"insurer2Naic": "11371",
"insurer2OnlineDeclination": "Y",
"insurer2Website": "https://www.gwccnet.com",
"insurer2ContactName": "Bob Broker",
"insurer2ContactPhoneEmail": "bob@example.com / 555-987-6543",
"insurer3Name": "Canal Insurance",
"insurer3Naic": "10464",
"insurer3OnlineDeclination": "N",
"insurer3Website": "https://www.canalinsurance.com",
"insurer3ContactName": "Sam Producer",
"insurer3ContactPhoneEmail": "sam@example.com / 555-555-0100"
},
"acknowledgeMissingOwnerDriverWarning": true,
"acknowledgeQuoteRevision": true,
"quoteRevisionKey": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
}
'import requests
url = "https://api.coverwhale.dev/v1/bind/{displayId}"
payload = {
"coverage": {
"includeAPD": "Y",
"includeAL": "Y",
"includeTGL": "Y",
"includeNTL": "Y",
"includeMTC": "Y",
"brokerFeeAL": 10,
"brokerFeeAPD": 10,
"brokerFeeMTC": 10,
"brokerFeeTGL": 10,
"brokerFeeNTL": 10,
"optInCWFinancing": "Y",
"electTRIA": "N",
"effectiveDate": "02/25/2026"
},
"bindingMethod": {
"signFirst": "N",
"retailAgentEmail": "agent@example.com",
"insuredEmail": "insured@example.com",
"insuredFullName": "John Doe",
"electronicSignature": "Y",
"acknowledgeMissingOwnerDriverWarning": True
},
"shippingAddress": {
"dashcam_shipping_address": "insured",
"street": "4310 W Jefferson Blvd",
"city": "Los Angeles",
"state": "CA",
"zip": "90016",
"county": "Los Angeles"
},
"diligentSearch": {
"insurer1Name": "Progressive Commercial",
"insurer1Naic": "24260",
"insurer1OnlineDeclination": "N",
"insurer1Website": "https://www.progressivecommercial.com",
"insurer1ContactName": "Jane Underwriter",
"insurer1ContactPhoneEmail": "jane@example.com / 555-123-4567",
"insurer2Name": "Great West Casualty",
"insurer2Naic": "11371",
"insurer2OnlineDeclination": "Y",
"insurer2Website": "https://www.gwccnet.com",
"insurer2ContactName": "Bob Broker",
"insurer2ContactPhoneEmail": "bob@example.com / 555-987-6543",
"insurer3Name": "Canal Insurance",
"insurer3Naic": "10464",
"insurer3OnlineDeclination": "N",
"insurer3Website": "https://www.canalinsurance.com",
"insurer3ContactName": "Sam Producer",
"insurer3ContactPhoneEmail": "sam@example.com / 555-555-0100"
},
"acknowledgeMissingOwnerDriverWarning": True,
"acknowledgeQuoteRevision": True,
"quoteRevisionKey": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
}
headers = {
"Content-Type": "<content-type>",
"Accept": "<accept>",
"AccessToken": "<api-key>"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'Content-Type': '<content-type>', Accept: '<accept>', AccessToken: '<api-key>'},
body: JSON.stringify({
coverage: {
includeAPD: 'Y',
includeAL: 'Y',
includeTGL: 'Y',
includeNTL: 'Y',
includeMTC: 'Y',
brokerFeeAL: 10,
brokerFeeAPD: 10,
brokerFeeMTC: 10,
brokerFeeTGL: 10,
brokerFeeNTL: 10,
optInCWFinancing: 'Y',
electTRIA: 'N',
effectiveDate: '02/25/2026'
},
bindingMethod: {
signFirst: 'N',
retailAgentEmail: 'agent@example.com',
insuredEmail: 'insured@example.com',
insuredFullName: 'John Doe',
electronicSignature: 'Y',
acknowledgeMissingOwnerDriverWarning: true
},
shippingAddress: {
dashcam_shipping_address: 'insured',
street: '4310 W Jefferson Blvd',
city: 'Los Angeles',
state: 'CA',
zip: '90016',
county: 'Los Angeles'
},
diligentSearch: {
insurer1Name: 'Progressive Commercial',
insurer1Naic: '24260',
insurer1OnlineDeclination: 'N',
insurer1Website: 'https://www.progressivecommercial.com',
insurer1ContactName: 'Jane Underwriter',
insurer1ContactPhoneEmail: 'jane@example.com / 555-123-4567',
insurer2Name: 'Great West Casualty',
insurer2Naic: '11371',
insurer2OnlineDeclination: 'Y',
insurer2Website: 'https://www.gwccnet.com',
insurer2ContactName: 'Bob Broker',
insurer2ContactPhoneEmail: 'bob@example.com / 555-987-6543',
insurer3Name: 'Canal Insurance',
insurer3Naic: '10464',
insurer3OnlineDeclination: 'N',
insurer3Website: 'https://www.canalinsurance.com',
insurer3ContactName: 'Sam Producer',
insurer3ContactPhoneEmail: 'sam@example.com / 555-555-0100'
},
acknowledgeMissingOwnerDriverWarning: true,
acknowledgeQuoteRevision: true,
quoteRevisionKey: 'aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa'
})
};
fetch('https://api.coverwhale.dev/v1/bind/{displayId}', 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.coverwhale.dev/v1/bind/{displayId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'coverage' => [
'includeAPD' => 'Y',
'includeAL' => 'Y',
'includeTGL' => 'Y',
'includeNTL' => 'Y',
'includeMTC' => 'Y',
'brokerFeeAL' => 10,
'brokerFeeAPD' => 10,
'brokerFeeMTC' => 10,
'brokerFeeTGL' => 10,
'brokerFeeNTL' => 10,
'optInCWFinancing' => 'Y',
'electTRIA' => 'N',
'effectiveDate' => '02/25/2026'
],
'bindingMethod' => [
'signFirst' => 'N',
'retailAgentEmail' => 'agent@example.com',
'insuredEmail' => 'insured@example.com',
'insuredFullName' => 'John Doe',
'electronicSignature' => 'Y',
'acknowledgeMissingOwnerDriverWarning' => true
],
'shippingAddress' => [
'dashcam_shipping_address' => 'insured',
'street' => '4310 W Jefferson Blvd',
'city' => 'Los Angeles',
'state' => 'CA',
'zip' => '90016',
'county' => 'Los Angeles'
],
'diligentSearch' => [
'insurer1Name' => 'Progressive Commercial',
'insurer1Naic' => '24260',
'insurer1OnlineDeclination' => 'N',
'insurer1Website' => 'https://www.progressivecommercial.com',
'insurer1ContactName' => 'Jane Underwriter',
'insurer1ContactPhoneEmail' => 'jane@example.com / 555-123-4567',
'insurer2Name' => 'Great West Casualty',
'insurer2Naic' => '11371',
'insurer2OnlineDeclination' => 'Y',
'insurer2Website' => 'https://www.gwccnet.com',
'insurer2ContactName' => 'Bob Broker',
'insurer2ContactPhoneEmail' => 'bob@example.com / 555-987-6543',
'insurer3Name' => 'Canal Insurance',
'insurer3Naic' => '10464',
'insurer3OnlineDeclination' => 'N',
'insurer3Website' => 'https://www.canalinsurance.com',
'insurer3ContactName' => 'Sam Producer',
'insurer3ContactPhoneEmail' => 'sam@example.com / 555-555-0100'
],
'acknowledgeMissingOwnerDriverWarning' => true,
'acknowledgeQuoteRevision' => true,
'quoteRevisionKey' => 'aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa'
]),
CURLOPT_HTTPHEADER => [
"Accept: <accept>",
"AccessToken: <api-key>",
"Content-Type: <content-type>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.coverwhale.dev/v1/bind/{displayId}"
payload := strings.NewReader("{\n \"coverage\": {\n \"includeAPD\": \"Y\",\n \"includeAL\": \"Y\",\n \"includeTGL\": \"Y\",\n \"includeNTL\": \"Y\",\n \"includeMTC\": \"Y\",\n \"brokerFeeAL\": 10,\n \"brokerFeeAPD\": 10,\n \"brokerFeeMTC\": 10,\n \"brokerFeeTGL\": 10,\n \"brokerFeeNTL\": 10,\n \"optInCWFinancing\": \"Y\",\n \"electTRIA\": \"N\",\n \"effectiveDate\": \"02/25/2026\"\n },\n \"bindingMethod\": {\n \"signFirst\": \"N\",\n \"retailAgentEmail\": \"agent@example.com\",\n \"insuredEmail\": \"insured@example.com\",\n \"insuredFullName\": \"John Doe\",\n \"electronicSignature\": \"Y\",\n \"acknowledgeMissingOwnerDriverWarning\": true\n },\n \"shippingAddress\": {\n \"dashcam_shipping_address\": \"insured\",\n \"street\": \"4310 W Jefferson Blvd\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"zip\": \"90016\",\n \"county\": \"Los Angeles\"\n },\n \"diligentSearch\": {\n \"insurer1Name\": \"Progressive Commercial\",\n \"insurer1Naic\": \"24260\",\n \"insurer1OnlineDeclination\": \"N\",\n \"insurer1Website\": \"https://www.progressivecommercial.com\",\n \"insurer1ContactName\": \"Jane Underwriter\",\n \"insurer1ContactPhoneEmail\": \"jane@example.com / 555-123-4567\",\n \"insurer2Name\": \"Great West Casualty\",\n \"insurer2Naic\": \"11371\",\n \"insurer2OnlineDeclination\": \"Y\",\n \"insurer2Website\": \"https://www.gwccnet.com\",\n \"insurer2ContactName\": \"Bob Broker\",\n \"insurer2ContactPhoneEmail\": \"bob@example.com / 555-987-6543\",\n \"insurer3Name\": \"Canal Insurance\",\n \"insurer3Naic\": \"10464\",\n \"insurer3OnlineDeclination\": \"N\",\n \"insurer3Website\": \"https://www.canalinsurance.com\",\n \"insurer3ContactName\": \"Sam Producer\",\n \"insurer3ContactPhoneEmail\": \"sam@example.com / 555-555-0100\"\n },\n \"acknowledgeMissingOwnerDriverWarning\": true,\n \"acknowledgeQuoteRevision\": true,\n \"quoteRevisionKey\": \"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Content-Type", "<content-type>")
req.Header.Add("Accept", "<accept>")
req.Header.Add("AccessToken", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.coverwhale.dev/v1/bind/{displayId}")
.header("Content-Type", "<content-type>")
.header("Accept", "<accept>")
.header("AccessToken", "<api-key>")
.body("{\n \"coverage\": {\n \"includeAPD\": \"Y\",\n \"includeAL\": \"Y\",\n \"includeTGL\": \"Y\",\n \"includeNTL\": \"Y\",\n \"includeMTC\": \"Y\",\n \"brokerFeeAL\": 10,\n \"brokerFeeAPD\": 10,\n \"brokerFeeMTC\": 10,\n \"brokerFeeTGL\": 10,\n \"brokerFeeNTL\": 10,\n \"optInCWFinancing\": \"Y\",\n \"electTRIA\": \"N\",\n \"effectiveDate\": \"02/25/2026\"\n },\n \"bindingMethod\": {\n \"signFirst\": \"N\",\n \"retailAgentEmail\": \"agent@example.com\",\n \"insuredEmail\": \"insured@example.com\",\n \"insuredFullName\": \"John Doe\",\n \"electronicSignature\": \"Y\",\n \"acknowledgeMissingOwnerDriverWarning\": true\n },\n \"shippingAddress\": {\n \"dashcam_shipping_address\": \"insured\",\n \"street\": \"4310 W Jefferson Blvd\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"zip\": \"90016\",\n \"county\": \"Los Angeles\"\n },\n \"diligentSearch\": {\n \"insurer1Name\": \"Progressive Commercial\",\n \"insurer1Naic\": \"24260\",\n \"insurer1OnlineDeclination\": \"N\",\n \"insurer1Website\": \"https://www.progressivecommercial.com\",\n \"insurer1ContactName\": \"Jane Underwriter\",\n \"insurer1ContactPhoneEmail\": \"jane@example.com / 555-123-4567\",\n \"insurer2Name\": \"Great West Casualty\",\n \"insurer2Naic\": \"11371\",\n \"insurer2OnlineDeclination\": \"Y\",\n \"insurer2Website\": \"https://www.gwccnet.com\",\n \"insurer2ContactName\": \"Bob Broker\",\n \"insurer2ContactPhoneEmail\": \"bob@example.com / 555-987-6543\",\n \"insurer3Name\": \"Canal Insurance\",\n \"insurer3Naic\": \"10464\",\n \"insurer3OnlineDeclination\": \"N\",\n \"insurer3Website\": \"https://www.canalinsurance.com\",\n \"insurer3ContactName\": \"Sam Producer\",\n \"insurer3ContactPhoneEmail\": \"sam@example.com / 555-555-0100\"\n },\n \"acknowledgeMissingOwnerDriverWarning\": true,\n \"acknowledgeQuoteRevision\": true,\n \"quoteRevisionKey\": \"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.coverwhale.dev/v1/bind/{displayId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Content-Type"] = '<content-type>'
request["Accept"] = '<accept>'
request["AccessToken"] = '<api-key>'
request.body = "{\n \"coverage\": {\n \"includeAPD\": \"Y\",\n \"includeAL\": \"Y\",\n \"includeTGL\": \"Y\",\n \"includeNTL\": \"Y\",\n \"includeMTC\": \"Y\",\n \"brokerFeeAL\": 10,\n \"brokerFeeAPD\": 10,\n \"brokerFeeMTC\": 10,\n \"brokerFeeTGL\": 10,\n \"brokerFeeNTL\": 10,\n \"optInCWFinancing\": \"Y\",\n \"electTRIA\": \"N\",\n \"effectiveDate\": \"02/25/2026\"\n },\n \"bindingMethod\": {\n \"signFirst\": \"N\",\n \"retailAgentEmail\": \"agent@example.com\",\n \"insuredEmail\": \"insured@example.com\",\n \"insuredFullName\": \"John Doe\",\n \"electronicSignature\": \"Y\",\n \"acknowledgeMissingOwnerDriverWarning\": true\n },\n \"shippingAddress\": {\n \"dashcam_shipping_address\": \"insured\",\n \"street\": \"4310 W Jefferson Blvd\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"zip\": \"90016\",\n \"county\": \"Los Angeles\"\n },\n \"diligentSearch\": {\n \"insurer1Name\": \"Progressive Commercial\",\n \"insurer1Naic\": \"24260\",\n \"insurer1OnlineDeclination\": \"N\",\n \"insurer1Website\": \"https://www.progressivecommercial.com\",\n \"insurer1ContactName\": \"Jane Underwriter\",\n \"insurer1ContactPhoneEmail\": \"jane@example.com / 555-123-4567\",\n \"insurer2Name\": \"Great West Casualty\",\n \"insurer2Naic\": \"11371\",\n \"insurer2OnlineDeclination\": \"Y\",\n \"insurer2Website\": \"https://www.gwccnet.com\",\n \"insurer2ContactName\": \"Bob Broker\",\n \"insurer2ContactPhoneEmail\": \"bob@example.com / 555-987-6543\",\n \"insurer3Name\": \"Canal Insurance\",\n \"insurer3Naic\": \"10464\",\n \"insurer3OnlineDeclination\": \"N\",\n \"insurer3Website\": \"https://www.canalinsurance.com\",\n \"insurer3ContactName\": \"Sam Producer\",\n \"insurer3ContactPhoneEmail\": \"sam@example.com / 555-555-0100\"\n },\n \"acknowledgeMissingOwnerDriverWarning\": true,\n \"acknowledgeQuoteRevision\": true,\n \"quoteRevisionKey\": \"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa\"\n}"
response = http.request(request)
puts response.read_body{
"status": "bind requested",
"submission_number": "264206519582",
"coverages": {},
"premium_finance": {
"provider": "capital",
"down_payment": 4250,
"monthly_payment": 1583.33,
"effective_apr": 0.0925,
"number_of_payments": 9,
"total_of_payments": 14250
}
}{
"status": "quote refresh started",
"reason_code": "quote_refresh_started",
"error": "The effective date changed, so a complete refreshed quote and document set is being generated.",
"quote_refresh": {
"revision_key": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"batch_id": "<string>",
"effective_date_before": "2023-12-25",
"effective_date_after": "2023-12-25",
"years_business_before": 123,
"months_business_before": 123,
"years_business_after": 123,
"months_business_after": 123
}
}{
"status": "failed",
"error": "Submission status must be quoted"
}{
"status": "failed",
"error": "An owner who is also a driver was not found on this submission.",
"warning_type": "missing_owner_driver",
"acknowledgement_required": true
}Authorizations
JWT returned as AccessToken by the /authentication endpoint (the Cognito ID token carrying the email claim). It expires after 3600 seconds.
Path Parameters
The submission display ID
Body
application/json
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
California diligent-search declarations for the surplus lines SL-2 form. Required only when the submission needs that form for California and Auto Liability is being bound. All three insurer names must be supplied and different from one another, all three NAIC codes must be supplied and different from one another, and each name and code must match the California admitted-insurers list. Ignored when those conditions do not apply.
Show child attributes
Show child attributes
Acknowledges the missing owner-driver warning returned as a 422. Accepted here or inside bindingMethod; either location has the same effect.
Example:
true
Required after an effective-date quote refresh, once the caller has displayed and accepted the returned quote revision differences.
Example:
true
The current quote revision identity returned by the refresh response.
Example:
"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
Response
Bind request submitted successfully. When the submission has Cover Whale financing, the response also includes a premium_finance block describing the loan terms.