Get a quote group
Returns the current state of a quote group — quotes and per-type errors.
Authorization
partnerApiKey API key issued by Swyfft. Pass in the X-SwyfftApiKey request header.
In: header
Path Parameters
ID of the quote group returned by Create a quote group.
Response Body
curl -X GET "https://example.com/partnerapi/v2/quote-groups/string"{ "quoteGroupId": "a51b0373-35ef-4927-98a1-cbda0d27b588", "quotes": [ { "quoteId": "826e5192-f8c6-4e24-aab3-3910e46c52b7", "ratingType": "Admitted", "carrierCode": "BIC", "annualPremium": 1250, "annualFeesTotal": 100, "grossAnnualPayment": 100, "expiresOn": "2025-06-15T14:30:00Z", "customizeUrl": "string", "premiumErrors": "1250.00", "elementGroups": [ { "groupName": "string", "elements": [ { "elementName": "string", "value": "1000.00", "defaultValue": "1000.00", "elementType": "string", "valueType": "1000.00", "editable": true, "conditionallyHidden": true, "displayFormat": "string", "minValue": 1000, "maxValue": 1000, "increment": 100, "choices": [ { "name": "John Smith", "value": "1000.00" } ] } ] } ] } ], "errors": [ { "ratingType": "Admitted", "code": "conflict", "message": "string" } ], "createdOn": "2025-06-15T14:30:00Z"}Create a quote group POST
Synchronously rates both Admitted and EAndS carriers for an HO property address. Get-or-create semantics: a repeat POST for the same agency and address returns the existing group while it still has live quotes. Sequential retries are safe. Overlapping retries (e.g. firing a second request while the first, still in flight after a client timeout, has not yet inserted its group) are not: the lookup-then-insert has no uniqueness constraint, so overlapping requests can create duplicate groups. Callers must not issue overlapping retries for the same address.
Update quote elements PATCH
Applies element changes to a specific quote within a group. Common elements (e.g. `YearBuilt`, `RoofAge`) are propagated to all quotes in the group, including the sibling rating type (Admitted ↔ EAndS).
