> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.truvo.com/api-reference/llms.txt.

# API reference


## API Docs

- API reference > Quotes [Discover capabilities](https://docs.truvo.com/api-reference/discover-capability.md)
- API reference > Quotes [Start a quote request](https://docs.truvo.com/api-reference/start-quote-request.md)
- API reference > Quotes [List quote requests](https://docs.truvo.com/api-reference/list-quote-requests.md)
- API reference > Quotes [Read a quote request](https://docs.truvo.com/api-reference/read-quote-request.md)
- API reference > Quotes [Cancel a quote request](https://docs.truvo.com/api-reference/cancel-quote-request.md)
- API reference > Quotes [Read a quote](https://docs.truvo.com/api-reference/read-quote.md)
- API reference > Sandbox [Select a sandbox scenario](https://docs.truvo.com/api-reference/set-sandbox-scenario.md)
- API reference > Sandbox [List sandbox scenarios](https://docs.truvo.com/api-reference/list-sandbox-scenarios.md)
- API reference > Sandbox [Reset the sandbox](https://docs.truvo.com/api-reference/reset-sandbox.md)
- API reference > Sandbox [Run a sandbox control](https://docs.truvo.com/api-reference/run-sandbox-controls.md)
- API reference > Sandbox [Read the sandbox workspace](https://docs.truvo.com/api-reference/read-sandbox-workspace.md)
- API reference > Feedback [Send feedback](https://docs.truvo.com/api-reference/send-feedback.md)
- API reference > Feedback [Read a feedback report](https://docs.truvo.com/api-reference/read-feedback.md)
- API reference > Request log [List recent requests](https://docs.truvo.com/api-reference/list-recent-requests.md)
- API reference > Request log [Read a recent request](https://docs.truvo.com/api-reference/read-request.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.truvo.com/api-reference/openapi.json)
- [OpenAPI YAML](https://docs.truvo.com/api-reference/openapi.yaml)


> **Note:** This page contains both a page directory (above) and the landing page content (below). The page directory is generated for agent use and does not appear on the landing page.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.truvo.com/api-reference/llms.txt.

# API reference

The Truvo API uses JSON request and response bodies, standard HTTP status codes, and bearer-key authentication. If you're new to it, start with the [Quickstart](/guides/quickstart).

> **Note**
>
> The reference pages don't have descriptions or examples yet. The [Quickstart](/guides/quickstart) shows a complete request.

## Base URL

```text
https://api.truvo.com/v1/
```

The sandbox and live use the same base URL. Your key picks the environment.

## Authentication

Send your key in the `Authorization` header as a bearer token. Sandbox keys start with `trv_sandbox_`, and live keys start with `trv_live_`. See [Keys and environments](/guides/authentication).

## Request keys

Starting a quote request, creating a webhook subscription, rotating its secret, sending a test event, replaying a delivery, and the three sandbox commands require an `Idempotency-Key` header, so you can retry them without starting a second request. A key replays for at least 24 hours. Reads don't take a key. See [Retry safely with request keys](/guides/request-keys).

## Asynchronous quote requests

Starting a quote request returns `202` right away. Read the quote request until its status is final, and use `Prefer: wait=N` (0 to 20 seconds) to hold each read open. See [Get quote results](/guides/polling).

## Errors

Every error uses one envelope with a code, a message, the fields at fault, and a retry action. See [Errors](/guides/errors).