> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withclasp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Quote

> Creates a group insurance quote from an existing employer or an uploaded census.

<Note>
  Use your sandbox API key to create quotes. Plans and rates returned in sandbox are sample data for integration testing and are not representative of live pricing. Contact Clasp to enable quoting with your live API key.
</Note>


## OpenAPI

````yaml schemas/2023-08-25/schema.yaml post /quotes
openapi: 3.0.3
info:
  title: ''
  version: 0.0.0
servers: []
security: []
paths:
  /quotes:
    post:
      tags:
        - quotes
      description: >-
        Creates a group insurance quote for an existing employer or from an
        uploaded member census.
      operationId: quotes_create
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/QuoteCreate'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/QuoteCreate'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Quote'
          description: ''
      security:
        - tokenAuth: []
components:
  schemas:
    QuoteCreate:
      type: object
      properties:
        employer:
          type: string
          nullable: true
          description: Existing employer ID. Provide this or census_upload, not both.
        census_upload:
          type: string
          format: binary
          description: Member census CSV. Requires employer_details when used.
        employer_details:
          $ref: '#/components/schemas/QuoteEmployerDetails'
        lines_of_coverage:
          type: array
          items:
            $ref: '#/components/schemas/QuotableLinesOfCoverageEnum'
          minItems: 1
      required:
        - lines_of_coverage
    Quote:
      type: object
      properties:
        id:
          type: string
          readOnly: true
          pattern: ^[-a-zA-Z0-9_]+$
        employer_details:
          $ref: '#/components/schemas/QuoteEmployerDetails'
        lines_of_coverage:
          type: array
          items:
            $ref: '#/components/schemas/QuotableLinesOfCoverageEnum'
        status:
          $ref: '#/components/schemas/QuoteStatusEnum'
          readOnly: true
        created_at:
          type: string
          format: date-time
          readOnly: true
        updated_at:
          type: string
          format: date-time
          readOnly: true
        employer:
          type: string
          readOnly: true
          nullable: true
        census_upload:
          type: string
          readOnly: true
          nullable: true
        submitted_at:
          type: string
          format: date-time
          readOnly: true
          nullable: true
        quote_plans:
          type: array
          items:
            type: string
          readOnly: true
      required:
        - id
        - lines_of_coverage
        - status
        - created_at
        - updated_at
        - quote_plans
    QuoteEmployerDetails:
      type: object
      properties:
        company_name:
          type: string
        zip_code:
          type: string
          pattern: ^\d{5}$
        state:
          $ref: '#/components/schemas/StateEnum'
        sic_code:
          type: string
          pattern: ^\d{4}$
        address_line1:
          type: string
        address_line2:
          type: string
        city:
          type: string
        phone_number:
          type: string
      required:
        - company_name
        - zip_code
        - state
        - sic_code
    QuotableLinesOfCoverageEnum:
      enum:
        - medical
        - dental
        - vision
        - life
        - voluntary_life
      type: string
    QuoteStatusEnum:
      enum:
        - draft
        - rates_returned
        - awaiting_carrier
      type: string
      description: |-
        * `draft` - Draft
        * `rates_returned` - Rates Returned
        * `awaiting_carrier` - Awaiting Carrier
    StateEnum:
      enum:
        - AL
        - AK
        - AZ
        - AR
        - CA
        - CO
        - CT
        - DE
        - DC
        - FL
        - GA
        - HI
        - ID
        - IL
        - IN
        - IA
        - KS
        - KY
        - LA
        - ME
        - MD
        - MA
        - MI
        - MN
        - MS
        - MO
        - MT
        - NE
        - NV
        - NH
        - NJ
        - NM
        - NY
        - NC
        - ND
        - OH
        - OK
        - OR
        - PA
        - RI
        - SC
        - SD
        - TN
        - TX
        - UT
        - VT
        - VA
        - WA
        - WV
        - WI
        - WY
      type: string
      description: |-
        * `AL` - AL
        * `AK` - AK
        * `AZ` - AZ
        * `AR` - AR
        * `CA` - CA
        * `CO` - CO
        * `CT` - CT
        * `DE` - DE
        * `DC` - DC
        * `FL` - FL
        * `GA` - GA
        * `HI` - HI
        * `ID` - ID
        * `IL` - IL
        * `IN` - IN
        * `IA` - IA
        * `KS` - KS
        * `KY` - KY
        * `LA` - LA
        * `ME` - ME
        * `MD` - MD
        * `MA` - MA
        * `MI` - MI
        * `MN` - MN
        * `MS` - MS
        * `MO` - MO
        * `MT` - MT
        * `NE` - NE
        * `NV` - NV
        * `NH` - NH
        * `NJ` - NJ
        * `NM` - NM
        * `NY` - NY
        * `NC` - NC
        * `ND` - ND
        * `OH` - OH
        * `OK` - OK
        * `OR` - OR
        * `PA` - PA
        * `RI` - RI
        * `SC` - SC
        * `SD` - SD
        * `TN` - TN
        * `TX` - TX
        * `UT` - UT
        * `VT` - VT
        * `VA` - VA
        * `WA` - WA
        * `WV` - WV
        * `WI` - WI
        * `WY` - WY
  securitySchemes:
    tokenAuth:
      type: http
      scheme: bearer
      description: API Key authentication with required prefix "Bearer"

````