Skip to navigation
Get started

Truvo API

Quote auto, renters, and pet insurance from inside your own product.
View as Markdown
You're reading a preview

Pages and examples can change before launch.

The Truvo API gets insurance quotes for your product. You send an applicant’s facts once, Truvo asks the carriers in the background, and you read the quotes when they’re ready.

Sign up at the portal and you can build in the sandbox right away, with no approval. To go live, book a call from the Go live page. After the call, Truvo approves your organization and issues your live keys.

Building with a coding agent? Give it agents.md, and connect it to the API with a sandbox key. To use Truvo yourself from Claude, ChatGPT, or another AI app, see Connect your AI agent.

Connect your AI agent

Add Truvo to Claude, ChatGPT, Claude Code, Cursor, or VS Code, and sign in with a Truvo account.

Quickstart

Get your first sandbox quote with a few curl requests.

Keys and environments

How keys work, and how the key prefix picks the sandbox or live.

API reference

Every operation, with its request and response schemas.

How a quote request works

1

Check what your key can do

GET /v1/capabilities returns the line, the environment, a JSON Schema of the facts the line requires, and the action types your key can use.

2

Start a quote request

POST /v1/quote-requests takes the facts for one line. The API answers with 202 and a quote request whose status is in_progress.

3

Wait for the result

Read the quote request until its status is no longer in_progress. The Prefer: wait header holds each read open until the request changes, for up to 20 seconds, so you don’t need a tight polling loop.

4

Read the quotes

Each quote gives its status, the price, the coverage, the availability, the next actions, and the evidence.

What the API covers today

  • Lines: personal auto, renters, and pet.
  • Buying: today, on every line, the customer buys through the link in each active quote’s continue_on_carrier_site action, opened in a new tab. Buying through the API is coming. A request on any line that completes with a quote can also return continue_on_truvo, a link to Truvo’s results page with more options.

Get help

Every error response has a request_id that starts with req_. Include it when you contact Truvo support at support@truvo.com.