Skip to main content
POST
/
quote
Get A Quote
curl --request POST \
  --url https://api.coverwhale.dev/v1/quote \
  --header 'Accept: <accept>' \
  --header 'AccessToken: <api-key>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "insuredInformation": {
    "legalName": "<string>",
    "yearsInBusiness": "1",
    "dotNumber": "0000000",
    "ownerName": "John Doe",
    "email": "j.doe@coverwhale.com",
    "dbaName": "<string>",
    "monthsInBusiness": "2",
    "insuranceContactFirstName": "<string>",
    "insuranceContactLastName": "<string>",
    "insuranceContactPhone": "<string>",
    "insuranceContactEmail": "j.doe@coverwhale.com"
  },
  "garageAddress": {
    "garageStreet": "mailingAddress.mailingStreet",
    "garageCity": "mailingAddress.mailingCity",
    "garageState": "CA",
    "garageZip": "12345",
    "garageCounty": "mailingAddress.mailingCounty",
    "garageCountry": "mailingAddress.mailingCountry"
  },
  "mailingAddress": {
    "mailingStreet": "<string>",
    "mailingCity": "<string>",
    "mailingState": "CA",
    "mailingZip": "12345",
    "mailingCounty": "<string>",
    "mailingCountry": "<string>"
  },
  "coverage": {
    "requestAl": "Y",
    "optAlPip": "N",
    "optAlUm": "N",
    "requestApd": "Y",
    "requestMtc": "Y",
    "requestTgl": "N",
    "requestNtl": "N",
    "effectiveDate": "12/12/2020"
  },
  "retailAgent": {
    "AgencyName": "Test Agency",
    "FirstName": "<string>",
    "LastName": "<string>",
    "Phone": "<string>",
    "Email": "j.doe@coverwhale.com",
    "Street": "mailingAddress.mailingStreet",
    "City": "mailingAddress.mailingCity",
    "State": "CA",
    "Zip": "12345"
  },
  "operations": {
    "opsLocal": "Y",
    "opsIntermediate": "N",
    "opsLongHaul": "N",
    "opsIntermodalPort": "N",
    "opsDumpTruckOther": "N",
    "opsDumpTruckSandGravel": "N",
    "opsEndDumper": "N",
    "opsLogging": "N",
    "opsRefrigirated": "N",
    "opsHotShot": "N",
    "opsOversizedOvernight": "N",
    "opsAutomobileHauler": "N",
    "opsHouseholdGoods": "N",
    "opsTanker": "N",
    "ineligibleOperations": "N",
    "filingsAlFederal": "N",
    "filingsAlState": "N",
    "priorInsuranceCancelledNonrenewed": "N"
  },
  "radius": {
    "radius0_50": "25",
    "radius51_200": "25",
    "radius201_500": "25",
    "radius501": "25"
  },
  "commoditiesRefrigeration": "N",
  "commodities": [
    {
      "commodityPercentage": "100"
    }
  ],
  "terminals": [
    {
      "terminalStreet": "<string>",
      "terminalCity": "<string>",
      "terminalState": "CA",
      "terminalZip": "12345",
      "terminalCounty": "<string>"
    }
  ],
  "vehicles": [
    {
      "vin": "<string>",
      "includeAPDTowing": "<string>",
      "year": "2020",
      "make": "<string>",
      "model": "<string>",
      "value": "5000",
      "classKey": "1",
      "bodyTypeKey": "box_truck"
    }
  ],
  "trailers": [
    {
      "vin": "<string>",
      "year": "2020",
      "make": "<string>",
      "model": "<string>",
      "value": "5000",
      "bodyTypeKey": "curtain_van_trailer"
    }
  ],
  "drivers": [
    {
      "firstName": "<string>",
      "lastName": "2020",
      "licenseState": "CA",
      "licenseNumber": "<string>",
      "dateOfBirth": "12/12/1988",
      "dateOfHire": "12/12/2020",
      "yearsExperience": "3",
      "accidents_total": "1",
      "violations_total": "0",
      "suspensions_total": "0",
      "eligibility": "Covered",
      "isOwner": true
    }
  ],
  "losses": {
    "1": {
      "lossAlCount": "1",
      "lossAlPaid": "0",
      "lossApdCount": "1",
      "lossApdPaid": "0",
      "lossMtcCount": "0",
      "lossMtcPaid": "0",
      "lossTglCount": "0",
      "lossTglPaid": "0",
      "lossNtlCount": "0",
      "lossNtlPaid": "0"
    }
  }
}
'
{
  "status": "Quoted",
  "submission_number": "2172961",
  "coverages": {
    "al": {
      "totalCost": 20617.52,
      "premium": 20617.52,
      "limit": 1000000,
      "deductible": 0
    }
  },
  "quote_pdf": "https://app.coverwhale.com/transportation/2172961/0/download_quote_pdf"
}

Authorizations

​
AccessToken
string
header
required

AWS Cognito access token obtained from the /authentication endpoint. Token expires after 3600 seconds.

Headers

​
Content-Type
string
required
​
Accept
string
required
​
AccessToken
string
required

Body

application/json
​
insuredInformation
object
required
​
garageAddress
object
required
​
mailingAddress
object
required
​
coverage
object
​
retailAgent
object

Retail Agent attributes are required for Agencies quoting that are wholesalers. It is ignored for Agencies quoting that are retailers themselves.

​
limits
object
​
operations
object
​
shippingAddress
object
​
radius
object

Combined need to be 100

​
commoditiesRefrigeration
enum<string>
default:N
Available options:
Y,
N
Example:

"N"

​
commodities
object[]

If multiple commodities, create a new row for each commodity

​
terminals
object[]
​
vehicles
object[]
​
trailers
object[]
​
drivers
object[]
​
losses
object

(we need last 3 years if available), maximum 3

Response

quote success

​
status
string

Created Submission status (Quoted, Declined)

​
errors
string[]

In case of declined here array of decline reasons

​
submission_number
string

The created submission number

​
coverages
object[]

Return the coverages and the premium values for al, apd, mtc, tgl and ntl if the submission is quoted