CrowBar | Update Quote Request | Corvus Skip to main content

Product: Smart Cyber

Update Quote Request

updateQuoteRequest(id: $id, action: $action, brokerQuoteRequestInfo: $brokerQuoteRequestInfo)
Product
Smart Cyber
Method
POST
Endpoint
Sandbox: https://api-sandbox.corvusinsurance.com/q Production: https://crowbar.corvusinsurance.com/q
Authentication
Send the headers X-API-KEY, X-USER-EMAIL, X-USER-NAME with every request. See Authentication.
Note that only id is required by the API, and omitting it will result in an error. Omitting action saves the quote request without submitting it. A submission requires brokerQuoteRequestInfo with coverageEffectiveAt, limits, and optionalData (which, despite its name, is required). Keys marked with * inside an object are required whenever that object is sent.
It is recommended to use a client like graphiql in order to view the graphql documentation and to have formatting available when writing graphql queries.

Arguments

Required Required to submit Optional

Pass these as variables.

Update Quote Request arguments
Name Type Required Description
id ID! Required

Id of the Quote Request to update (see Create Quote Request)

action Action Optional

The SUBMIT action should be used for saving the quote request values and submitting it for quoting. This action will only update optionalData and limits if the quote request has a status of INCOMPLETE.

The RESUBMIT action may be used to modify values and re-quote. However the previous quote data will be overwritten. This action is only available to auto-quote eligible quote requests with a status of SUBMITTED or QUOTES_SHARED, or to referred quotes with a status of SUBMITTED up until an underwriter begins work rating the submission. A quote that is auto-quote eligible may be updated as many times up until a bind is requested. A quote that has been referred cannot be resubmitted once an underwriter picks it up for review. If an underwriter has begun reviewing a submission or has shared the quote and the RESUBMIT action is used, the following error will be returned: Cannot resubmit a quote request unless its application type is 'form' or 'broker_api'. If a broker would like to update their submission at this point, they need to reach out to the underwriter directly. You may query the underwriter contact details by adding the underwriter name and email variables to the getQuoteRequest call.

query GetQuoteRequest($id: ID!) {
  quoteRequest(id: $id) {
    applicationSignatureUrl
    client {
      name
    }
    declineLossReason
    policyFeeCents
    quoteData(first: 5) {
      edges {
        node {
          id
        }
      }
    }
    status
    subjectivities(first: 5) {
      edges {
        node {
          id
        }
      }
    }
    underwriter {
      name
      email
    }
  }
}
brokerQuoteRequestInfo BrokerQuoteRequestInput Required to submit
coverageEffectiveAt Date Required

Coverage start date

Format must be YYYY-MM-DD

limits [LimitInput!] Required

To request more than one coverage option, add one entry for each option here. Do not create a new client and quote request for each option.

Must be an array with a length of between 1 and 3 values composed of the following keys:

aggregateCents Int Required

Must be an integer representing the limit in cents.

deductibleCents Int Required

Must be an integer representing the deductible in cents.

hasTria Boolean Optional

Boolean value indicating whether coverage for Certified Acts of Terrorism should be included for the insured. Defaults to True.

true - include TRIA coverage

false - waive TRIA coverage

** If TRIA coverage is waived, insured must sign TRIA exclusion waiver (included in quote documents) prior to policy issuance.

isIndication Boolean Optional

Boolean value to signify if submission is for a non-bindable indication quote.

true - this submission is an indication

false - this submission is a request for a bindable quote

brokerMessage String Optional

A message to the underwriter about this submission, up to 10,000 characters. A non-blank message also sends Corvus an email notification about the update.

dueAt Date Optional

The date by which you need the quote. Format must be YYYY-MM-DD.

If omitted, the existing due date is kept.

primaryWebsite String Optional

Updates the client's primary website, up to 255 characters. Use the same formats as createClient (see Create Client).

Response fields

Select only the fields you need in the selection set.

Update Quote Request response fields
Name Type Description
id ID

Quote request id you can use in future requests

isAutoQuoteEligible Boolean

Will be true if a quote will be generated in the next five minutes. If the attribute is false, the quote will be referred to an underwriter for manual review. If multiple limit options are submitted (e.g. $1M, $2M, and $3M) and some are eligible while others are not, the entire quote will be referred.

brokerAutoQuoteIneligibleReasons String

Specific reasons why quote is ineligible for auto-quoting. Note: since this quote request is auto-quote eligible there are no reasons available.

Additional Information

When a quote request returns false for isAutoQuoteEligible there will be more information available in the following field:

Additional information fields
Name Type Description
brokerAutoQuoteIneligibleReasons String

If we modified the cyberApplicationControls within the variables sent in the example to have the following:

"claims" : true

we would see a reason provide in the response as

Date validations

The top-level coverageEffectiveAt and coverageEndAt arguments are checked before the update is saved. A failed check returns one of these plain-text errors and nothing is changed:

  • coverageEffectiveAt can be no more than 7 days in the past. The error is coverage_effective_at cannot be older than 7 days ago.
  • coverageEndAt must be today or later. The error is coverage_end_at cannot be backdated.

Dates before the year 1900 are rejected with a validation error. If coverageEndAt is not provided, it defaults to one year after coverageEffectiveAt. Dates are evaluated in UTC.

Closing a quote request

Use the top-level status argument to close a quote request you no longer need, for example because the client bound elsewhere. Include declineLossReason to tell us why.

Closing a quote request arguments
Name Type Required Description
status QuoteRequestStatus Optional

API partners can set INCOMPLETE, SUBMITTED, or CLOSED. Any other value returns Broker cannot update status to <status>.

A quote request with status BIND_REQUESTED or COMPLETED cannot be closed. The request fails with a validation error on status: Invalid transition - Cannot change from <status> to closed. (see Errors).

declineLossReason DeclineLossReason Optional

Only these values are accepted from API partners:

BOUND_ELSEWHERE_PREMIUM_UNCOMPETITIVE

BOUND_ELSEWHERE_COVERAGE_DIFFERENCE

BOUND_ELSEWHERE_ALTERNATE_MARKET_PRIOR_RELATIONSHIP

DECIDED_NOT_PURCHASE

INCUMBENT_RENEWED

UNCOMFORTABLE_BINDING_NEW_MARKET

OTHER

Any other value is ignored without an error, and declineLossNotes is ignored with it.

declineLossNotes String Optional

Free-text explanation, up to 10,000 characters, for example the name of the carrier the client bound with.

Copied
mutation CloseQuoteRequest($id: ID!, $status: QuoteRequestStatus, $declineLossReason: DeclineLossReason, $declineLossNotes: String) {  updateQuoteRequest(    id: $id    status: $status    declineLossReason: $declineLossReason    declineLossNotes: $declineLossNotes  ) {    id    status    declineLossReason  }}