# Cover Whale API

- [Introduction](https://docs.coverwhale.com/introduction.md): Get started with the Cover Whale API for commercial trucking insurance
- [Getting Started](https://docs.coverwhale.com/getting-started.md): From zero to your first Cover Whale API call — and your first webhook — in about 10 minutes
- [Base URL](https://docs.coverwhale.com/base-url.md): Production and test environments for the Cover Whale API
- [Quickstart](https://docs.coverwhale.com/quickstart.md): Make your first Cover Whale API call in 5 minutes
- [Authentication](https://docs.coverwhale.com/authentication.md): How to authenticate with the Cover Whale API
- [Integration Checklist](https://docs.coverwhale.com/integration-checklist.md): What you need before making your first API call
- [Error Handling](https://docs.coverwhale.com/error-handling.md): Understanding API error responses and troubleshooting common issues
- [Submissions](https://docs.coverwhale.com/guides/submissions.md): Understanding the Cover Whale submission lifecycle
- [Quoting](https://docs.coverwhale.com/guides/quoting.md): How to get indications and quotes through the Cover Whale API
- [Policy Lifecycle](https://docs.coverwhale.com/guides/policy-lifecycle.md): Binding quotes and managing policies through the Cover Whale API
- [Endorsements](https://docs.coverwhale.com/guides/endorsements.md): How to modify a bound policy through the endorsement workflow
- [Integration Patterns](https://docs.coverwhale.com/guides/integration-patterns.md): Common questions and recommended approaches for building with the Cover Whale API
- [Webhooks](https://docs.coverwhale.com/webhooks.md): Get pushed a signed notification the moment a submission changes state — instead of polling.
- [Check API Health](https://docs.coverwhale.com/api-reference/authentication/check-api-health.md): Simple, unauthenticated health probe. Confirms the API service is reachable and its database connection is up. No `AccessToken` is required — use this to smoke-test connectivity before authenticating.
- [Get Authentication Token](https://docs.coverwhale.com/api-reference/authentication/get-authentication-token.md): Request an authentication and refresh token with user credentials
- [Get a password reset Token](https://docs.coverwhale.com/api-reference/authentication/get-a-password-reset-token.md): Request a password reset token for the provide username. The reset token will be emailed to the username/email if found.
- [Reset Password with Token](https://docs.coverwhale.com/api-reference/authentication/reset-password-with-token.md): Reset the password of associated username with provided reset token. Reset token is emailed to username/email if found from GET endpoint.
- [Get Coverage Guidelines](https://docs.coverwhale.com/api-reference/quoting/coverage-guidelines.md): Cover Whale's published coverage appetite, as JSON. This returns the same guidelines rendered on [coverwhale.com/coverage](https://coverwhale.com/coverage) — the product lines, the Auto Liability guidelines, the combined guidelines for Physical Damage / Motor Truck Cargo / Non-Trucking Liability / T…
- [Pre-Screen a DOT Number](https://docs.coverwhale.com/api-reference/quoting/pre-screen-dot.md): Run Cover Whale's DOT pre-screen for a carrier and get back the eligibility verdict plus a small pre-fill payload. This is the same check the Cover Whale submission page runs when an agent types in a DOT number, exposed so you can pre-qualify a carrier before building a quote.
- [Get An Indication](https://docs.coverwhale.com/api-reference/quoting/get-an-indication.md): Submit an indication request with basic submission details to get preliminary pricing
- [Get A Quote](https://docs.coverwhale.com/api-reference/quoting/get-a-quote.md): Submit a full quote request with complete submission details
- [Send Quote Request Email](https://docs.coverwhale.com/api-reference/quoting/send-quote-request-email.md): Send an email notification requesting a quote for the provided email address
- [Get Submission Status](https://docs.coverwhale.com/api-reference/submissions/get-submission-status.md): Retrieve the current status and details of a submission by its display ID.
- [List Submission Transactions](https://docs.coverwhale.com/api-reference/submissions/get-submission-transactions.md): List every transaction on a submission (new business plus each endorsement, reinstatement, and cancellation) with a lightweight status summary. Use this to track how a policy has changed over time without pulling each transaction's full detail.
- [Post a Public Reply](https://docs.coverwhale.com/api-reference/submissions/post-submission-public-reply.md): Post a public reply / note back onto a submission — the inbound counterpart to the outbound `submission.public_reply` webhook. The note is recorded on the submission and is visible to Cover Whale staff on the account's Notes tab; it does not trigger a webhook back to you.
- [Get a Public Reply Note](https://docs.coverwhale.com/api-reference/submissions/get-submission-note.md): Retrieve the body of a single public reply note by its note ID — the pull counterpart to the content-free `submission.public_reply` webhook. The webhook tells you *that* a reply happened and gives you a `note_id`; this endpoint returns the text.
- [List Webhook Subscriptions](https://docs.coverwhale.com/api-reference/webhooks/list-webhook-subscriptions.md): List every webhook subscription belonging to your account. The signing `secret` is never returned here — it is shown only once, when a subscription is created or its secret is rotated.
- [Create a Webhook Subscription](https://docs.coverwhale.com/api-reference/webhooks/create-webhook-subscription.md): Register an HTTPS endpoint to receive events for your account's submissions. **The signing `secret` is returned only in this response (and on rotate-secret) — store it now; it is never shown again.** Use it to verify the signature on every delivery.
- [Get a Webhook Subscription](https://docs.coverwhale.com/api-reference/webhooks/get-webhook-subscription.md): Retrieve one of your subscriptions by id. A subscription that does not exist, or that belongs to another account, returns `404`.
- [Update a Webhook Subscription](https://docs.coverwhale.com/api-reference/webhooks/update-webhook-subscription.md): Update a subscription's endpoint URL, event types, and/or active flag. All fields are optional — send only what you want to change. Set `active: false` to pause deliveries without deleting the subscription.
- [Delete a Webhook Subscription](https://docs.coverwhale.com/api-reference/webhooks/delete-webhook-subscription.md): Permanently delete a subscription. Deliveries stop immediately. Returns `204` with no body.
- [Rotate a Subscription Secret](https://docs.coverwhale.com/api-reference/webhooks/rotate-webhook-subscription-secret.md): Generate a new signing secret for a subscription. **The new `secret` is returned only in this response** — store it now. The previous secret keeps verifying for a short grace window so in-flight deliveries signed with it still validate.
- [Bind a Quoted Submission](https://docs.coverwhale.com/api-reference/binding/bind-a-quoted-submission.md): Submit a bind request for a quoted submission. The submission must be in 'Quoted' status.
- [Get commodities available in the system](https://docs.coverwhale.com/api-reference/reference-data/get-commodities-available-in-the-system.md): Get the list of all available commodity types
- [Update Submission](https://docs.coverwhale.com/api-reference/submission-data/update-submission.md): Updates a submission's fields (address, radius, limits, loss history, etc.). Only sends fields that need to change.
- [Get Submission Details](https://docs.coverwhale.com/api-reference/submission-data/get-submission-details.md): Returns comprehensive submission data including coverages, vehicles, drivers, trailers, and insured info.
- [Download Document](https://docs.coverwhale.com/api-reference/submission-data/download-document.md): Downloads a submission document by type. Returns the PDF as a streamed response.
- [Recalculate Rates](https://docs.coverwhale.com/api-reference/submission-data/recalculate-rates.md): Triggers a full premium recalculation on the submission. Admin-only.
- [Calculate state taxes and fees](https://docs.coverwhale.com/api-reference/submission-data/calculate-taxes-and-fees.md): Stateless new-business, non-admitted calculation using the same state rules as Cover Whale quoting.
- [Get Taxes and Fees](https://docs.coverwhale.com/api-reference/submission-data/get-taxes-and-fees.md): Returns a detailed taxes and fees breakdown per coverage line.
- [Add Vehicle](https://docs.coverwhale.com/api-reference/submission-data/add-vehicle.md): Adds a vehicle (power unit) to a submission or endorsement.
- [Update Vehicle](https://docs.coverwhale.com/api-reference/submission-data/update-vehicle.md): Updates fields on an existing vehicle. Only send fields that need to change.
- [Remove Vehicle](https://docs.coverwhale.com/api-reference/submission-data/remove-vehicle.md): Removes a vehicle from a submission or endorsement.
- [Add Driver](https://docs.coverwhale.com/api-reference/submission-data/add-driver.md): Adds a driver to a submission or endorsement.
- [Update Driver](https://docs.coverwhale.com/api-reference/submission-data/update-driver.md): Updates fields on an existing driver. Only send fields that need to change.
- [Remove Driver](https://docs.coverwhale.com/api-reference/submission-data/remove-driver.md): Removes a driver from a submission or endorsement.
- [Add Trailer](https://docs.coverwhale.com/api-reference/submission-data/add-trailer.md): Adds a trailer to a submission or endorsement.
- [Remove Trailer](https://docs.coverwhale.com/api-reference/submission-data/remove-trailer.md): Removes a trailer from a submission or endorsement.
- [Quote Endorsement](https://docs.coverwhale.com/api-reference/submission-data/quote-endorsement.md): Recalculates rates on an endorsement and sets its status to Quoted. Only applicable to endorsement transactions.
- [Create Endorsement](https://docs.coverwhale.com/api-reference/policy-lifecycle/create-endorsement.md): Creates a new endorsement on a bound policy. The submission must be in a bound state.
- [Request Cancellation](https://docs.coverwhale.com/api-reference/policy-lifecycle/request-cancellation.md): Creates a cancellation endorsement. Optional reason arrays become approval defaults when reason-aware request intake is enabled. Request enforcement uses the state-and-reason minimum from the request day and can lengthen dates; approval may lengthen them again. Responses retain existing fields and a…
- [Approve Cancellation](https://docs.coverwhale.com/api-reference/policy-lifecycle/approve-cancellation.md): Approves a pending cancellation endorsement. An explicit external reason overrides a stored request default. When approval enforcement is enabled, PAS re-evaluates applicable cancellation dates from the approval day, recalculates final values, and holds unresolved or out-of-term dates for manual rev…

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.