We can't find the internet
Attempting to reconnect
Something went wrong!
Hang in there while we get back on track
Corvus Insurance API
Quote-to-bind for Smart Cyber and Smart Tech E+O over a single GraphQL endpoint. Set
productType
to
CYBER
or TECH_EO; the brokerage you submit for decides the product variant.
Environments
Each environment has its own Developer Portal, login and API key. All requests are HTTP POST.
This is a GraphQL API, not a REST API. Each environment has one endpoint, and every query and mutation is sent to it. Errors come back in the response body, usually with HTTP 200. See GraphQL for how requests and responses are shaped.
| Environment | GraphQL endpoint | Developer Portal |
|---|---|---|
| Sandbox | api-sandbox.corvusinsurance.com/developer | |
| Production | crowbar.corvusinsurance.com/developer |
The webhook source IP addresses for each environment are shown to partners who sign in to the Developer Portal.
Make your first request
-
1
Get invited
Access is by invitation. Email api@corvusinsurance.com with each developer's name and which environments they need.
-
2
Copy your API key
Sign in to the Developer Portal for that environment, pick your API partner and reveal the key.
-
3
Send the required headers
Then create a client and a quote request. Send each operation as the
queryfield of the body and its inputs asvariables. See Authentication for what each header does.
X-API-KEY: <your API key>X-USER-EMAIL: <email of the user making the request>X-USER-NAME: <name of the user making the request>X-API-VERSION: v2.0 # optionalContent-Type: application/jsonAccept: application/json
Explore the API
- Quote to bind Create and submit quote requests, upload supporting documents, then bind. Smart Cyber and Smart Tech E+O.
- Policies and documents Look up policy details and download binders and policy documents by category.
- Renewals Find renewals for your policies and read renewal quote requests. Read-only through the API.
- Webhooks Seven event types, from Quote Ready to Policy Non-Renewal, signed with your API key.
- Testing in Sandbox Test domains and headers that rate, bind or decline a quote on demand.
How quoting works
-
Set
productTypetoCYBERorTECH_EO. The brokerage you submit for decides the variant: wholesale brokerages get Smart Cyber and Smart Tech E+O, and retail brokerages get CyberRisk and CyberRisk Tech, reported asCYBER_ES_RETAILorTECH_EO_RETAIL. - Eligible Smart Cyber submissions auto-quote: limits up to and including $3M for companies up to $100M in annual revenue, and up to and including $2M for companies under $10M. Others are referred to an underwriter.
- Smart Tech E+O does not auto-quote. Every submission is referred.
- Referred quotes are reviewed within 24–48 hours and end in a quote or a decline.
-
Excess product lines (
CYBER_EXCESS,CYBER_EXCESS_RETAIL,TECH_EO_EXCESS) are not supported through the API, even though they appear in theProductTypeenum.
Latest release
All release notes
You can now retrieve and list your quote requests and policies with only your X-API-KEY.
Send neither
X-USER-EMAIL
nor
X-USER-NAME
and you no longer need to know which broker a record belongs to, so the
quoteRequestId
or
policyId
in a webhook is enough to look it up. Requests that send both user headers work as before.
-
quoteRequestandpolicyreturn a record only if your API partner submitted it. Any other record returns anunauthorizederror, even if it belongs to a brokerage you work with. -
quoteRequestsandpoliciesrequire abrokerageIdfor a brokerage linked to your API partner, and list only that brokerage's records that your API partner submitted. - Other queries still need both user headers. Mutations always require both user headers so that every change is attributed to a broker. A mutation sent with only your API key is rejected.
See Authentication.