CrowBar | Get Renewal Quote Request | Corvus Skip to main content
Sign in

Get Renewal Quote Request

QUERY
renewalQuoteRequest(id: $id, expiringPolicyNumber: $expiringPolicyNumber)
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.
  • Returns a quote request with the same fields as Get Quote Request (see Smart Cyber or Smart Tech E+O). Returns not_found if no renewal exists for the expiring policy, or if it belongs to another brokerage.
  • Provide exactly one of id or expiringPolicyNumber. If both are provided, id takes precedence and expiringPolicyNumber is ignored. Omitting both returns an error.
  • A renewal quote request is INCOMPLETE during solicitation, SUBMITTED once the underwriter takes it up, and QUOTES_SHARED when the quote is shared. Do not poll for a quote at solicitation time.
  • The Renewal Solicitation Open webhook fires for every enrolled renewal, whether or not the quote is ready.
  • Persist quoteRequestId from the renewal_solicitation_open webhook. It does not change after manual updates, and Quote Ready carries the same value. expiringPolicyNumber appears in both events, and expiringPolicyId appears in the solicitation event.

Arguments

Required Required to submit Optional

Pass these as variables.

Get Renewal Quote Request arguments
Name Type Required Description
id ID Optional

Id of the renewal quote request (not the id of the expiring policy). Takes precedence over expiringPolicyNumber.
expiringPolicyNumber String Optional

The policy number of the expiring policy being renewed. Used only when id is not provided.

Response fields

Select only the fields you need in the selection set.

Get Renewal Quote Request response fields
Name Type Description
renewalQuoteRequest.id ID

Id of the renewal quote request
renewalQuoteRequest.status QuoteRequestStatus

Where the renewal is in its lifecycle

Find renewals from your policies

Each policy has a renewalQuoteRequest field that returns its renewal quote request, or null if the renewal has not been created yet. Use it with the policies connection to list upcoming renewals without knowing their ids in advance.

  • The top-level policies connection returns bound and issued policies where you are the broker and that expire within the next 180 days. Pages can contain up to 200 policies (see Policies).
  • For one client's policies, use client(id: $clientId) { policies { ... } } instead.