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

# Create Quote

> Creates a new quote request with documents from external URLs.



## OpenAPI

````yaml /openapi.json post /quotes
openapi: 3.1.0
info:
  title: Fortis Evaluations API
  version: 1.0.0
servers:
  - url: https://api.fortiseval.com/v1
    description: Live
  - url: https://sandbox-api.fortiseval.com/v1
    description: Sandbox
security:
  - http: []
paths:
  /quotes:
    post:
      tags:
        - Quote
      summary: Create Quote
      description: Creates a new quote request with documents from external URLs.
      operationId: quotes.store
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateQuoteRequest'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    const: Quote request created successfully.
                  data:
                    $ref: '#/components/schemas/Quote'
                required:
                  - message
                  - data
        '422':
          $ref: '#/components/responses/ValidationException'
components:
  schemas:
    CreateQuoteRequest:
      type: object
      properties:
        quote_type:
          $ref: '#/components/schemas/QuoteType'
          description: Service type
        evaluation_type:
          type:
            - string
            - 'null'
          description: Academic evaluation specific
          enum:
            - diploma_evaluation
            - course_by_course_evaluation
            - work_experience_evaluation
        desired_equivalency:
          type:
            - string
            - 'null'
          maxLength: 255
        translation_preference:
          type:
            - string
            - 'null'
          enum:
            - client_provided
            - translation_service
        expert_letter_type:
          $ref: '#/components/schemas/ExpertLetterType'
          description: Expert letter specific
        source_language:
          type:
            - string
            - 'null'
          description: Translation specific
          maxLength: 50
        target_language:
          type:
            - string
            - 'null'
          maxLength: 50
        turnaround:
          $ref: '#/components/schemas/QuoteTurnaroundCategory'
          description: Turnaround
        reference:
          type:
            - string
            - 'null'
          description: Client details
          maxLength: 255
        notes:
          type:
            - string
            - 'null'
          maxLength: 10000
        team:
          type:
            - string
            - 'null'
          description: Team assignment
        document_urls:
          type: array
          description: >-
            Documents - external URLs and/or ids of files staged via the files
            API
          items:
            type: string
            format: uri
            maxLength: 2048
          minItems: 1
          maxItems: 50
        document_ids:
          type: array
          items:
            type: string
            maxLength: 255
          minItems: 1
          maxItems: 50
        candidate:
          type: object
          description: Candidate information
          properties:
            first_name:
              type:
                - string
                - 'null'
              maxLength: 255
            middle_name:
              type:
                - string
                - 'null'
              maxLength: 255
            last_name:
              type:
                - string
                - 'null'
              maxLength: 255
            pronoun_type:
              $ref: '#/components/schemas/PronounType'
            visa_type:
              $ref: '#/components/schemas/VisaType'
        cc_emails:
          type:
            - array
            - 'null'
          items:
            type: string
            format: email
            maxLength: 255
          maxItems: 10
      required:
        - quote_type
      title: CreateQuoteRequest
    Quote:
      type: object
      properties:
        id:
          type: string
          description: The unique identifier for the quote (e.g. quot_xxxxx).
        url:
          type: string
          description: The URL to view this quote in the Portal.
        number:
          type: string
        status:
          $ref: '#/components/schemas/QuoteStatus'
        quote_type:
          $ref: '#/components/schemas/QuoteType'
        requested_turnaround:
          anyOf:
            - $ref: '#/components/schemas/QuoteTurnaroundCategory'
            - type: 'null'
        tat_value:
          type:
            - integer
            - 'null'
          description: The turnaround time value.
        tat_range:
          anyOf:
            - $ref: '#/components/schemas/TurnaroundRange'
            - type: 'null'
        turnaround_label:
          type:
            - string
            - 'null'
          description: A human-readable turnaround label.
        has_guaranteed_delivery:
          type: boolean
          description: Whether a guaranteed delivery date is set.
        guaranteed_delivery_at:
          type:
            - string
            - 'null'
        total_cents:
          type: integer
          description: The total in cents, computed from quote items.
        total:
          type: string
          description: The formatted total (e.g. "150.00").
        items:
          type: array
          description: The quote line items.
          items:
            $ref: '#/components/schemas/QuoteItem'
        cart:
          anyOf:
            - $ref: '#/components/schemas/Cart'
              description: The associated cart.
            - type: 'null'
        documents:
          type: array
          description: The associated documents.
          items:
            $ref: '#/components/schemas/Document'
        expires_at:
          type:
            - string
            - 'null'
        requested_at:
          type:
            - string
            - 'null'
        approved_at:
          type:
            - string
            - 'null'
        canceled_at:
          type:
            - string
            - 'null'
        created_at:
          type: string
        updated_at:
          type: string
      required:
        - id
        - url
        - number
        - status
        - quote_type
        - requested_turnaround
        - tat_value
        - tat_range
        - turnaround_label
        - has_guaranteed_delivery
        - guaranteed_delivery_at
        - total_cents
        - total
        - expires_at
        - requested_at
        - approved_at
        - canceled_at
        - created_at
        - updated_at
      title: Quote
    QuoteType:
      type: string
      enum:
        - translation
        - academic_evaluation
        - expert_opinion_letter
        - perm_ad
      title: QuoteType
    ExpertLetterType:
      type: string
      enum:
        - work_experience_evaluation_letter
        - h1b_expert_opinion_letter
        - specialty_occupation_letter
        - tn_expert_opinion_letter
        - perm_expert_opinion_letter
        - specialized_knowledge_expert_letter
        - managerial_capacity_expert_letter
        - extraordinary_ability_expert_letter
        - national_interest_waiver_expert_letter
        - general_academic_evaluation
        - course_mapping_letter
        - custom_letter
      title: ExpertLetterType
    QuoteTurnaroundCategory:
      type: string
      enum:
        - standard
        - next_day
        - same_day
        - expedited
      title: QuoteTurnaroundCategory
    PronounType:
      type: string
      enum:
        - masculine
        - feminine
        - neutral
      title: PronounType
    VisaType:
      type: string
      enum:
        - h1b
        - h1b1
        - e3
        - tn
        - l1a
        - l1b
        - o1a
        - o1b
        - eb1a
        - eb1b
        - eb2_niw
        - eb2_perm
        - eb3
        - eb5
        - perm
        - p1
        - j1
        - k1
        - r1
        - other
      title: VisaType
    QuoteStatus:
      type: string
      enum:
        - pending
        - requested
        - awaiting_payment
        - approved
        - cancelled
      title: QuoteStatus
    TurnaroundRange:
      type: string
      enum:
        - hour
        - day
        - week
        - month
      title: TurnaroundRange
    QuoteItem:
      type: object
      properties:
        quantity:
          type: integer
        price:
          type: integer
          description: The line item price in cents.
        subtotal:
          type: integer
          description: The line item subtotal in cents (price × quantity).
        currency:
          type: string
          description: The currency code (e.g. "usd").
        service_name:
          type:
            - string
            - 'null'
          description: The name of the service.
        service_code:
          type:
            - string
            - 'null'
          description: The code of the service.
      required:
        - quantity
        - price
        - subtotal
        - currency
      title: QuoteItem
    Cart:
      type: object
      properties:
        id:
          type: string
          description: The unique identifier for the cart (e.g. cart_xxxxx).
        number:
          type: string
          description: The cart UUID.
        status:
          $ref: '#/components/schemas/CartStatus'
        payment_status:
          anyOf:
            - $ref: '#/components/schemas/PaymentStatus'
            - type: 'null'
        is_individual:
          type: boolean
          description: Whether this is an individual (non-business) order.
        turnaround_type:
          anyOf:
            - $ref: '#/components/schemas/TurnaroundType'
            - type: 'null'
        translation_preference_type:
          anyOf:
            - $ref: '#/components/schemas/TranslationPreferenceType'
            - type: 'null'
        physical_copy:
          type: boolean
          description: Whether a physical copy was requested.
        cc_emails:
          type:
            - array
            - 'null'
          description: CC email addresses for notifications.
          items:
            type: string
        subtotal:
          type: number
          description: The cart subtotal in dollars.
        total:
          type: number
          description: The cart total in dollars.
        last_activity_at:
          type:
            - string
            - 'null'
        unsubscribed_at:
          type:
            - string
            - 'null'
        paid_at:
          type:
            - string
            - 'null'
        created_at:
          type: string
        updated_at:
          type: string
      required:
        - id
        - number
        - status
        - payment_status
        - is_individual
        - turnaround_type
        - translation_preference_type
        - physical_copy
        - cc_emails
        - subtotal
        - total
        - last_activity_at
        - unsubscribed_at
        - paid_at
        - created_at
        - updated_at
      title: Cart
    Document:
      type: object
      properties:
        id:
          type: string
          description: The unique identifier for the document (e.g. doc_xxxxx).
        title:
          type:
            - string
            - 'null'
          description: The document title.
        document_type:
          anyOf:
            - $ref: '#/components/schemas/DocumentType'
            - type: 'null'
        document_category:
          anyOf:
            - $ref: '#/components/schemas/DocumentCategory'
            - type: 'null'
        document_role:
          anyOf:
            - $ref: '#/components/schemas/DocumentRole'
            - type: 'null'
        file_name:
          type:
            - string
            - 'null'
        file_ext:
          type:
            - string
            - 'null'
          description: The file extension (e.g. "pdf").
        mime_type:
          type:
            - string
            - 'null'
          description: The MIME type (e.g. "application/pdf").
        size:
          type:
            - integer
            - 'null'
          description: The file size in bytes.
        page_count:
          type:
            - integer
            - 'null'
          description: The number of pages in the document.
        word_count:
          type:
            - integer
            - 'null'
          description: The word count of the document.
        character_count:
          type:
            - integer
            - 'null'
          description: The character count of the document.
        source_language_code:
          type:
            - string
            - 'null'
          description: The ISO 639-1 language code of the source document.
        source_language:
          type:
            - string
            - 'null'
          description: The human-readable source language name.
        metadata:
          type:
            - array
            - 'null'
          description: AI-extracted document metadata.
          items: {}
        analysis_completed_at:
          type:
            - string
            - 'null'
        created_at:
          type: string
        updated_at:
          type: string
      required:
        - id
        - title
        - document_type
        - document_category
        - document_role
        - file_name
        - file_ext
        - mime_type
        - size
        - page_count
        - word_count
        - character_count
        - source_language_code
        - source_language
        - metadata
        - analysis_completed_at
        - created_at
        - updated_at
      title: Document
    CartStatus:
      type: string
      enum:
        - in_progress
        - abandoned
        - expired
        - completed
      title: CartStatus
    PaymentStatus:
      type: string
      enum:
        - paid
        - unpaid
      title: PaymentStatus
    TurnaroundType:
      type: string
      enum:
        - standard
        - next_day
        - same_day
        - expedited
      title: TurnaroundType
    TranslationPreferenceType:
      type: string
      enum:
        - documents_in_english
        - client_provided
        - translation_service
      title: TranslationPreferenceType
    DocumentType:
      type: string
      enum:
        - credential_evaluation
        - translation
        - certified_translation
        - diploma
        - transcript
        - cv
        - professional_license
        - enrollment_report
        - id
        - passport
        - letter
        - recommendation_letter
        - expert_opinion_letter
        - work_experience_letter
        - admission_letter
        - portfolio
        - research_paper
        - certificate
        - birth_certificate
        - marriage_certificate
        - name_change_document
        - verification_letter
        - thesis
        - course_outline
        - background_check_report
        - medical_certificate
        - financial_statement
        - military_service_record
        - training_certificate
        - linkedin_profile
        - language_proficiency_certificate
        - deans_list_certificate
        - grade_report
        - academic_award
        - patent_document
        - membership_document
        - other
      title: DocumentType
    DocumentCategory:
      type: string
      enum:
        - vital
        - government
        - academic
        - financial
        - marketing
        - personal
        - professional
        - medical
        - legal
        - technical
        - identification
        - employment
        - immigration
        - property
        - intellectual_property
        - communication
        - research
        - security
        - military
        - certification
        - transportation
        - insurance
        - environmental
        - entertainment
        - cultural
        - other
      title: DocumentCategory
    DocumentRole:
      type: string
      enum:
        - source
        - reference
        - translation
        - evaluation
        - course_evaluation
        - expert_letter
        - work_product
        - other
      title: DocumentRole
  responses:
    ValidationException:
      description: Validation error
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                description: Errors overview.
              errors:
                type: object
                description: A detailed description of each field that failed validation.
                additionalProperties:
                  type: array
                  items:
                    type: string
            required:
              - message
              - errors
  securitySchemes:
    http:
      type: http
      scheme: bearer

````