1. Quote
Olli
  • System
    • Confirm API connectivity
      GET
    • API health status
      GET
  • Programs
    • List programs available to the caller
      GET
    • Get program by ID
      GET
    • Get full detail on one program
      GET
  • Appetite
    • Search NAICS codes
      GET
    • Classifications for a NAICS code
      GET
    • Appetites for a classification
      GET
    • Full catalog for a classification
      GET
    • Appetite details (product-filtered)
      GET
  • Rate
    • Rate eligible programs for a risk
      POST
    • Sensitivity analysis across coverage options
      POST
  • Quote
    • List quote folios
      GET
    • Create a quote folio
      POST
    • View a quote folio (light — all programs)
      GET
    • Re-quote (new bindable, same group)
      POST
    • View one application (full — includes form schema + plan details)
      GET
    • Edit form_payload only
      POST
  • Bind
    • Bind quote requests
      POST
  • Policy
    • Get policy — full detail
      GET
    • Renewal payment
      POST
    • Cancel a policy
      POST
  • Schemas
    • Schemas
    • Response
    • Rates
  • Schemas
    • SuccessResponse
    • SuccessEnvelope
    • AttestationItem
    • ISO8601DateTime
    • ErrorResponse
    • ErrorEnvelope
    • BindQuotePayment
    • PingResponse
    • Pricing
    • Pagination
    • OffsetPagination
    • NaicsListResponse
    • PricingData
    • PricingNode
    • ValidationErrorEnvelope
    • BindQuoteItem
    • HealthResponse
    • CarrierRef
    • RateRequest
    • ProgramType
    • PagePagination
    • ClassificationListResponse
    • QuoteApplication
    • ProgramMarketing
    • PaginationWithPage
    • PolicyProgramNode
    • BindRequest
    • ProgramSummary
    • RateResult
    • CreateProgramTypeInput
    • PagePaginationWithMore
    • QuoteCarrierProgram
    • PlanDetails
    • ClassificationStub
    • PolicyCarrierNode
    • PolicyCustomer
    • ProgramEndorsement
    • MatrixRequest
    • UpdateProgramTypeInput
    • NaicsCode
    • QuoteFolio
    • ProgramNode
    • ClassificationFull
    • PolicyTermNode
    • PolicyBilling
    • ProgramOption
    • MatrixResult
    • ProgramListItem
    • Classification
    • CreateQuoteProgram
    • ProgramNodeFull
    • AppetiteItem
    • PolicySellerNode
    • PolicyDocumentAccess
    • ProgramTerm
    • Program
    • CreateClassificationInput
    • CreateQuoteRequest
    • CarrierNode
    • CatalogLimit
    • RateOption
    • PolicyCustomerNode
    • BoundPolicyReceipt
    • ProgramDetail
    • CreateProgramInput
    • UpdateClassificationInput
    • UpdateApplicationRequest
    • OptionItem
    • CatalogRule
    • AppliedOptions
    • PolicyInsuredItem
    • BindQuoteResult
    • ProductTypeEnum
    • UpdateProgramInput
    • AppetiteSummary
    • EndorsementItem
    • CatalogProductOption
    • PolicyLocationItem
    • BindSummary
    • RatingMethodEnum
    • AppetiteListItem
    • PaymentFrequency
    • CatalogEndorsement
    • PolicyEndorsementItem
    • BindResponseData
    • FormField
    • AppetiteCatalogEntry
    • PaymentOption
    • CatalogItem
    • PolicyCoverageItem
    • BindResponse
    • AppetiteDetail
    • DocumentItem
    • PolicyDocumentItem
    • BindResponseAllFailed
    • AppetiteRule
    • NoticeItem
    • NaicsWithClassificationsResponse
    • PolicyEventItem
    • ErrorResponse400
    • CreateAppetiteRuleInput
    • TermAndCondition
    • PolicyPaymentItem
    • ErrorResponseSimple
    • UpdateAppetiteRuleInput
    • FormSectionField
    • AppetiteListResponse
    • PolicyFull
    • AppetiteLimit
    • FormSection
    • CatalogResponse
    • AcceptedTerm
    • CreateAppetiteLimitInput
    • QuoteResponseProgramLight
    • Payment
    • UpdateAppetiteLimitInput
    • QuoteResponseProgramFull
    • PayBody
    • QuoteResponseLight
    • RecordedAcceptance
    • BillingConfig
    • PayResultToken
    • PayResultInvoiceAccount
    • PayResultCarrierCharge
    • PayResultFinalized
    • QuoteFolioCreated
    • CancelBody
    • CancelResult
    • CreateQuoteRatePayloadRequest
    • EditApplicationRequest
    • SystemPayload
    • FormPayload
  1. Quote

View a quote folio (light — all programs)

GET
/v1/quote/{quoteId}
Return the enriched quote folio: folio metadata + all programs with pricing, options, endorsements, documents, notices, payment options, and billing config. Poll this endpoint after POST /v1/quote until all programs reach a terminal status.
Each entry in quotes[] is a fully-rendered program card — no second call needed to render pricing, badges, or payment UI.
Application status values on each program:
StatusMeaning
quotingSubmitted to carrier, awaiting response
quotedCarrier returned pricing
declinedCarrier declined this risk
quote_failedCarrier returned an error or timed out
boundPolicy issued
For the full application detail including the form schema, use GET /v1/quote/{quoteId}/applications/{quoteRequestId}.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Responses

🟢200
application/json
Enriched quote folio with all programs
Bodyapplication/json

🟠401Unauthorized
🟠401Unauthorized
🟠404NotFound
🟠404NotFound
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/v1/quote/' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Success
{
    "success": true,
    "data": {
        "quoteId": "075e8d7c-b648-4e0a-9f22-e3ac727c672d",
        "source": "web",
        "status": "quoted",
        "clientState": {
            "line": "commercial",
            "business": {
                "legalBusinessName": "Acme Café LLC"
            }
        },
        "createdAt": "2026-05-01T10:00:00Z",
        "expiresAt": "2026-05-15T23:59:59Z",
        "quotes": [
            {
                "id": "3c4d5e6f-7a8b-9012-cdef-012345678901",
                "quoteRequestId": "0e7c2e9a-fa75-4f6c-9978-a112ad078d7e",
                "attemptNumber": 1,
                "status": "quoted",
                "effectiveDate": null,
                "expirationDate": null,
                "validUntil": "2026-05-15T23:59:59Z",
                "ratedAt": "2026-05-01T10:00:05Z",
                "programState": {
                    "coverage": {
                        "glLimit": 1000000,
                        "bppLimit": 50000
                    }
                },
                "program": {
                    "id": "d81f38e5-1f74-554d-c321-6ee4d1ee63e6",
                    "name": "Business Owners Policy",
                    "code": "COTERIE-BOP",
                    "type": "BOP",
                    "slug": "coterie-bop",
                    "description": "Comprehensive coverage combining general liability and commercial property.",
                    "tagline": "The all-in-one policy for small businesses.",
                    "tier": "standard",
                    "isFeatured": true,
                    "renewalType": "renewable",
                    "renewalFrequency": "annual",
                    "quoteValidityDays": 14,
                    "marketing": {
                        "shortDescription": "GL + property in one policy.",
                        "badges": [
                            "Top Rated",
                            "Most Popular"
                        ],
                        "cardHighlights": [
                            "$1M general liability",
                            "Property coverage included"
                        ]
                    }
                },
                "carrier": {
                    "id": "b2c3d4e5-0000-0000-0000-000000000002",
                    "name": "Coterie Insurance",
                    "code": "coterie",
                    "quoteId": "CARRIER-REF-00123",
                    "referenceIds": {
                        "applicationId": "APP-789",
                        "externalId": null
                    }
                },
                "pricing": {
                    "annualPremium": 966,
                    "monthlyPremium": 80.5,
                    "taxes": 0,
                    "fees": 0,
                    "totalAnnual": 966,
                    "totalMonthly": 80.5,
                    "currency": "USD"
                },
                "options": [
                    {
                        "key": "glLimit",
                        "label": "General Liability Limit",
                        "values": [
                            300000,
                            500000,
                            1000000,
                            2000000
                        ],
                        "selectedValue": 1000000
                    },
                    {
                        "key": "bppLimit",
                        "label": "Business Personal Property",
                        "values": [
                            10000,
                            25000,
                            50000,
                            100000
                        ],
                        "selectedValue": 50000
                    }
                ],
                "endorsements": [
                    {
                        "key": "liquorLiabilityEndorsement",
                        "name": "Liquor Liability",
                        "included": false,
                        "available": true
                    },
                    {
                        "key": "dataBreachEndorsement",
                        "name": "Data Breach",
                        "included": true,
                        "available": true
                    }
                ],
                "paymentOptions": [
                    {
                        "method": "card",
                        "label": "Credit Card",
                        "frequencies": [
                            {
                                "frequency": "annual",
                                "amount": 966
                            },
                            {
                                "frequency": "monthly",
                                "amount": 80.5
                            }
                        ]
                    }
                ],
                "billing": {
                    "method": "stripe",
                    "publishableKey": "pk_live_51xxxxxxxxxxxxx",
                    "billingDescriptor": "Coterie Insurance",
                    "allowedMethods": [
                        "credit_card"
                    ]
                },
                "documents": [
                    {
                        "type": "quote_proposal",
                        "label": "Quote Proposal",
                        "url": "https://api.coterieinsurance.com/documents/quote-proposal-00123.pdf"
                    },
                    {
                        "type": "application",
                        "label": "Application",
                        "url": "https://api.coterieinsurance.com/documents/application-00123.pdf"
                    }
                ],
                "notices": [
                    {
                        "text": "This policy does not cover liquor liability. Add the endorsement if your business serves alcohol.",
                        "type": "notice",
                        "level": "underwriting"
                    }
                ],
                "termsAndConditions": []
            }
        ],
        "summary": {
            "totalAnnual": 966,
            "totalMonthly": 80.5,
            "quotedCount": 1,
            "failedCount": 0
        }
    }
}
Modified at 2026-05-05 23:26:52
Previous
Create a quote folio
Next
Re-quote (new bindable, same group)
Built with