Skip to navigation
API referenceQuotes

List quote requests

View as Markdown

Also available as the MCP tool list_quote_requests.

Authentication

AuthorizationBearer

Your Truvo API key, sent as a bearer token. The prefix selects sandbox (trv_sandbox_) or live (trv_live_).

Headers

Truvo-VersionenumRequiredDefaults to 2026-09-26

The contract revision of this request, which every operation in this document requires. This document describes 2026-09-26. Served revisions: 2026-09-26. A missing header, or one that names no served revision exactly, answers invalid_version (400), and its field error lists the served revisions in allowed_values, newest first.

Allowed values:

Query parameters

limitintegerOptional1-100Defaults to 10
The most quote requests on one page, from 1 to 100.
cursorstringOptionalformat: "^[A-Za-z0-9_-]{1,512}$"

The next_cursor of the page before. Send the same filters with it. A cursor from another list answers invalid_cursor.

statusenumOptional
Only quote requests in this state.
Allowed values:
lineenumOptional
Only quote requests for this line.
Allowed values:
created_afterdatetimeOptional
Only quote requests created after this time. An RFC 3339 time with an offset.
created_beforedatetimeOptional
Only quote requests created before this time. An RFC 3339 time with an offset.
updated_sincedatetimeOptional
Only quote requests that changed at or after this time. To resync, send the start time of your last complete sync, less a few minutes, and read each page. An RFC 3339 time with an offset.

Response headers

Request-Idstringformat: "^req_[0-9a-f]{16}$"

The ID of this answer. An error body repeats it as request_id.

Truvo-Versionstringformat: "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"

The contract revision of this answer: the revision that the request named in Truvo-Version. A 404, and a refusal sent before Truvo knows your revision (401, 413, a 429 for failed authentication, and a 400 invalid_version), name the current revision and take its shape.

RateLimit-LimitintegerOptional
The calls this window allows, for the limit you're closest to reaching. The window is one minute or one UTC day. A fixed window allows a burst of up to twice the limit across a window edge.
RateLimit-RemainingintegerOptional
The calls left in the current window.
RateLimit-ResetintegerOptional
Seconds until the current window ends and the count resets.

Response

List quote requests.
quote_requestslist of objects
One page of quote requests, newest first.
next_cursorstring or nullformat: "^[A-Za-z0-9_-]{1,512}$"
Send it as cursor, with the same filters, to read the next page. Null on the last page.
has_moreboolean

True when another page follows. Read again with next_cursor while it’s true.

events_cursorstring or null>=1 character

A cursor for GET /v1/events, on the first page only. Read every page, then read the event feed from this cursor: each change that the pages don’t show comes after it. It is null on each later page, and while the event feed is off for this key.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error