---
title: "POST /policy/{tenantLocator}/quotes/underwritePreview"
method: POST
path: "/policy/{tenantLocator}/quotes/underwritePreview"
---

# POST /policy/{tenantLocator}/quotes/underwritePreview

`POST /policy/{tenantLocator}/quotes/underwritePreview`

## Request

- Base URL: `https://docs.socotra.com`
- URL: `https://docs.socotra.com/policy/{tenantLocator}/quotes/underwritePreview`
- Auth: none declared
- TypeScript: <https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi/docs/policy/:tenantLocator/quotes/underwritePreview/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `tenantLocator` string, uuid, required

## Request body

- QuoteCreateRequest
  - `productName` string, required
  - `accountLocator` string, ulid, required
  - `startTime` string, date-time, required
  - `endTime` string, date-time
  - `expirationTime` string, date-time
  - `currency` string
  - `timezone` string
  - `jurisdiction` string
  - `coverageTerms` object
  - `data` object, required
  - `elements` ElementCreateRequest[]
    - `type` string, required
    - `parentLocator` string, ulid
    - `elements` ElementCreateRequest[], required
    - `coverageTerms` object
    - `data` object
    - `staticLocator` string, ulid
  - `durationBasis` 'years' | 'months' | 'weeks' | 'days' | 'hours'
  - `preferences` Preferences
    - `installmentPreferences` InstallmentPreferences
      - `cadence` 'none' | 'fullPay' | 'weekly' | 'everyOtherWeek' | 'monthly' | 'quarterly' | 'semiannually' | 'annually' | 'thirtyDays' | 'everyNDays'
      - `anchorMode` 'generateDay' | 'termStartDay' | 'dueDay'
      - `generateLeadDays` integer
      - `dueLeadDays` integer
      - `installmentWeights` number[], required
      - `maxInstallmentsPerTerm` integer
      - `installmentPlanName` string
      - `anchorType` 'none' | 'dayOfMonth' | 'anchorTime' | 'dayOfWeek' | 'weekOfMonth'
      - `dayOfMonth` integer
      - `dayOfWeek` 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday'
      - `weekOfMonth` 'none' | 'first' | 'second' | 'third' | 'fourth' | 'fifth'
      - `anchorTime` string, date-time
      - `autopayLeadDays` number
  - `delinquencyPlanName` string
  - `autoRenewalPlanName` string
  - `billingLevel` 'account' | 'inherit' | 'policy'
  - `region` string
  - `quoteGroupLocator` string, ulid
  - `static` object
  - `contacts` ContactRoles[], required
    - `contactLocator` string, ulid, required
    - `roles` string[], required
  - `invoiceFeeAmount` number, required
  - `termDuration` integer
  - `startWithTermNumber` integer
  - `producerCode` string
  - `proxyPayerLocator` string, ulid

## Response `200`

OK

- QuoteUnderwritingResponse
  - `tenantLocator` string, uuid, required
  - `quoteLocator` string, ulid, required
  - `accountLocator` string, ulid, required
  - `quoteState` 'draft' | 'validated' | 'earlyUnderwritten' | 'priced' | 'underwritten' | 'accepted' | 'issued' | 'underwrittenBlocked' | 'declined' | 'rejected' | 'refused' | 'discarded', required
  - `productName` string, required
  - `startTime` string, date-time, required
  - `endTime` string, date-time, required
  - `duration` number, required
  - `durationBasis` 'years' | 'months' | 'weeks' | 'days' | 'hours', required
  - `underwritingStatus` string, required
  - `underwritingFlags` UnderwritingFlagResponse[], required
    - `locator` string, ulid, required
    - `level` 'info' | 'block' | 'decline' | 'reject' | 'approve', required
    - `referenceType` 'quote' | 'transaction', required
    - `referenceLocator` string, ulid, required
    - `note` string, required
    - `tag` string, required
    - `elementLocator` string, ulid
    - `createdBy` string, uuid, required
    - `createdTime` string, date-time, required
    - `clearedBy` string, uuid, required
    - `clearedTime` string, date-time, required
    - `taskCreationResponse` TaskCreationResponse, required
      - `taskLocator` string, ulid, required
      - `status` 'succeeded' | 'failed', required
  - `validationResult` ValidationResult
    - `validationItems` ValidationItemResponse[]
      - `elementType` string, required
      - `locator` string, ulid, required
      - `errors` string[], required
    - `success` boolean, required

---

[API](https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi.md) - [All operations](https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi/revisions/77ee7d8172b9?raw)