Quote group lifecycle
How quote groups are created, read and adjusted in Partner API v2.
V2 replaces V1's asynchronous create-and-poll flow with a synchronous model: you POST a quote group and receive the fully rated result in the same response. There is nothing to poll.
Create
POST /partnerapi/v2/quote-groups rates both the Admitted and E&S carriers for a property address and returns the rated group.
The call is get-or-create. Sending the same request again for the same agency and address returns the existing group (while it still has live quotes) instead of creating a new one, so retrying sequentially after a timeout is safe.
Don't retry in parallel
Overlapping retries, sent before the original request has finished, are not guaranteed to be deduplicated and can create a second quote group for the same address.
Read
GET /partnerapi/v2/quote-groups/{quoteGroupId} returns the group as it stands. It is a plain read: groups have no pending or processing state.
Adjust
PATCH /partnerapi/v2/quote-groups/{quoteGroupId}/quotes/{quoteId} applies element changes, re-rates, and returns the whole updated group. Elements shared by both rating types (for example YearBuilt and RoofAge) are copied to the sibling Admitted or E&S quote in the same group automatically.
Use GET /partnerapi/v2/capabilities/{productLine}/{state} beforehand to find which element names and values each carrier accepts in a state.
No bindable quotes
A group can come back with no bindable quotes at all. That is still a 200 response: quotes is empty and errors explains, per rating type, why it declined.