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

# Request a quote

> Requests a quote for the account between locations or ports.



## OpenAPI

````yaml /openapi.json post /v1/quote-requests
openapi: 3.1.0
info:
  title: OVRSEA API
  version: 1.3.2
servers:
  - url: https://api.cf.ovrsea.com
security: []
paths:
  /v1/quote-requests:
    post:
      tags:
        - Quote requests
      summary: Request a quote
      description: Requests a quote for the account between locations or ports.
      requestBody:
        content:
          application/json:
            schema:
              properties:
                cargo:
                  properties:
                    containers:
                      description: >-
                        Containers of a full container load, one line per
                        container type. Required when `load_type` is `fcl`.
                      items:
                        properties:
                          container_type:
                            type: string
                            enum:
                              - twenty_foot_standard
                              - twenty_foot_reefer
                              - twenty_foot_flat_rack
                              - twenty_foot_open_top
                              - forty_foot_standard
                              - forty_foot_reefer
                              - forty_foot_flat_rack
                              - forty_foot_open_top
                              - forty_foot_highcube_standard
                              - forty_foot_highcube_reefer
                              - forty_foot_highcube_flat_rack
                              - forty_foot_highcube_open_top
                              - forty_five_foot_highcube_standard
                          count:
                            description: Number of containers of this type.
                            example: 2
                            maximum: 100
                            minimum: 1
                            type: integer
                        required:
                          - container_type
                          - count
                        type: object
                      maxItems: 13
                      type: array
                    loads:
                      description: >-
                        Package lines of a less than container load. Required
                        when `load_type` is `lcl`.
                      items:
                        properties:
                          count:
                            description: Number of packages of the line.
                            example: 4
                            minimum: 1
                            type: integer
                          package_type:
                            description: >-
                              `colis` is a carton, `palletized_80_120` and
                              `palletized_100_120` are pallets of that footprint
                              in centimetres, `palletized_specific` is a pallet
                              of another footprint, `solid_box` is a rigid crate
                              and `vrac` is bulk.
                            enum:
                              - colis
                              - palletized_80_120
                              - palletized_100_120
                              - palletized_specific
                              - solid_box
                              - vrac
                            type: string
                          total_volume:
                            description: Volume of the whole line, in cubic `volume_unit`.
                            example: 3840000
                            type: number
                          total_weight:
                            description: Weight of the whole line, in `weight_unit`.
                            example: 1200
                            type: number
                          volume_unit:
                            enum:
                              - cm
                              - in
                            type: string
                          weight_unit:
                            enum:
                              - kg
                              - lbs
                            type: string
                        required:
                          - package_type
                          - volume_unit
                          - weight_unit
                        type: object
                      type: array
                  type: object
                cargo_ready_date:
                  example: '2027-03-01'
                  format: date
                  type: string
                desired_delivery_date:
                  example: '2027-04-15'
                  format: date
                  type: string
                freight_mode:
                  enum:
                    - air
                    - ocean
                    - rail
                  type: string
                incoterm:
                  type: string
                  enum:
                    - exw
                    - fca
                    - fas
                    - fob
                    - cpt
                    - cfr
                    - cif
                    - cip
                    - dap
                    - ddp
                    - dpu
                    - dat
                  example: fob
                load_type:
                  description: >-
                    `fcl` cargo is described by `cargo.containers`, `lcl` cargo
                    by `cargo.loads`.
                  enum:
                    - fcl
                    - lcl
                  type: string
                name:
                  type: string
                  example: June Air Export USA
                needs_ad_valorem_insurance:
                  type: boolean
                route:
                  description: >-
                    Needs an origin, the pickup location or the departure port,
                    and a destination, the arrival port or the delivery
                    location.
                  properties:
                    delivery_location_id:
                      description: Id of a location returned by `/v1/locations`.
                      example: '45'
                      pattern: ^[0-9]{1,18}$
                      type: string
                    delivery_port_id:
                      description: >-
                        Id of the arrival port, as returned by
                        `/v1/ports/{locode}` for the same `freight_mode`.
                      example: '2'
                      pattern: ^[0-9]{1,18}$
                      type: string
                    pickup_location_id:
                      description: Id of a location returned by `/v1/locations`.
                      example: '23'
                      pattern: ^[0-9]{1,18}$
                      type: string
                    pickup_port_id:
                      description: >-
                        Id of the departure port, as returned by
                        `/v1/ports/{locode}` for the same `freight_mode`.
                      example: '1'
                      pattern: ^[0-9]{1,18}$
                      type: string
                  type: object
                specific_instructions:
                  example: Call the warehouse before delivery
                  type: string
                transported_goods:
                  properties:
                    goods_description:
                      example: Ceramic tiles
                      type: string
                  type: object
                urgent:
                  description: Flags the request as urgent.
                  type: boolean
              required:
                - freight_mode
                - load_type
                - needs_ad_valorem_insurance
                - route
              type: object
        required: true
      responses:
        '201':
          description: The created quote request.
          content:
            application/json:
              schema:
                description: The created quote request.
                properties:
                  ovrsea_quote_request_id:
                    description: >-
                      OVRSEA id of the quote request. It becomes the
                      `ovrsea_shipment_id` of the shipment if an offer is
                      accepted.
                    example: CDEF
                    type: string
                required:
                  - ovrsea_quote_request_id
                type: object
        '400':
          description: A required field is missing or a field is invalid.
          content:
            application/json:
              schema:
                description: A required field is missing or a field is invalid.
                type: string
        '429':
          description: >-
            The account reached its shipment and quote request creation limit.
            The `Retry-After` header gives the number of seconds to wait.
          content:
            application/json:
              schema:
                description: >-
                  The account reached its shipment and quote request creation
                  limit. The `Retry-After` header gives the number of seconds to
                  wait.
                type: string

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.