# Create a new LTL Quote

This endpoint allows you to create a new LTL quote.

Endpoint: POST /api/ltl/quotes
Version: 1.0.0
Security: bearerAuth

## Request fields (application/json):

  - `pickup_zipcode` (string, required)
    Example: "91730"

  - `pickup_city` (string, required)
    Example: "RANCHO CUCAMONGA"

  - `pickup_state` (string, required)
    State abbreviation
    Example: "CA"

  - `pickup_country` (string,null)
    Default value is 'US'
    Example: "US"

  - `pickup_address_type` (string, required)
    when home delivery is selected, pickup_address_type must be business
    Enum: "business", "residential", "limitedAccess"

  - `pickup_accessorials` (array,null)
    when home delivery is selected, pickup_accessorials must be empty
    Enum: "inside", "liftgate"

  - `destination_zipcode` (string, required)
    Example: "08086"

  - `destination_city` (string, required)
    Example: "LEONARDS"

  - `destination_state` (string, required)
    State abbreviation
    Example: "NJ"

  - `destination_country` (string,null)
    Default value is 'US'
    Example: "US"

  - `destination_address_type` (string, required)
    when home delivery is selected, destination_address_type must be residential
    Enum: "business", "residential", "limitedAccess"

  - `destination_accessorials` (array,null)
    when home delivery is selected, destination_accessorials can only contain homeDelivery
    Enum: "inside", "liftgate", "appointment", "homeDelivery"

  - `pickup_date` (string, required)
    Pickup date can not be in the past
    Example: "2024-12-07"

  - `timeout` (integer,null)
    Timeout in seconds to wait for the quote to be processed. Default value is 30 seconds.
    Example: 30

  - `cargo_value` (integer,null)
    The cargo value will be used in the calculation of the insurance premium.
    Example: 2000

  - `floor` (integer,null)
    Floor number. Only available when home delivery is selected.
    Example: 12

  - `is_elevator` (boolean,null)
    Whether elevator is available. Only available when home delivery is selected.
    Example: true

  - `is_military` (boolean,null)
    Whether it is a military address. Only available when home delivery is selected.
    Example: true

  - `items` (array, required)
    Array of items to be shipped

  - `items.weight_unit` (string, required)
    Enum: "lbs", "kg"

  - `items.dimension_unit` (string, required)
    Enum: "in", "cm"

  - `items.height` (integer, required)
    Example: 72

  - `items.length` (integer, required)
    Example: 48

  - `items.width` (integer, required)
    Example: 40

  - `items.total_weight` (integer, required)
    Example: 1200

  - `items.units` (integer, required)
    Example: 1

  - `items.pieces` (integer,null)
    Required when home delivery is not selected. Optional when home delivery is selected.
    Example: 1

  - `items.package_type` (string, required)
    Enum: "Bag", "Bale", "Box", "Bucket", "Bundle", "Can", "Carton", "Case", "Coil", "Crate", "Cylinder", "Drums", "Pail", "Pieces", "Pallet", "Reel", "Roll", "Skid", "Tube", "Tote"

  - `items.description` (string, required)
    Description of the item
    Example: "general goods"

## Response 201 fields (application/json):

  - `data` (object)

  - `data.rates` (array)

  - `data.rates.rate_number` (string)
    Unique identifier for the rate
    Example: "7a357734-b2f6-11ef-9861-0242ac110003"

  - `data.rates.rate` (number)
    The cost of the rate
    Example: "2482.04"

  - `data.rates.carrier_name` (string)
    Name of the carrier
    Example: "UPS Freight"

  - `data.rates.carrier_code` (string)
    Code of the carrier
    Example: "UPGF"

  - `data.rates.expiration_date` (string)
    Rate expiration date and time
    Example: "12/06/2024 02:48"

  - `data.rates.estimated_pickup_date` (string)
    Estimated pickup date
    Example: "12/31/2024"

  - `data.rates.estimated_delivery_date_min` (string)
    Earliest estimated delivery date
    Example: "01/13/2025"

  - `data.rates.estimated_delivery_date_max` (string)
    Latest estimated delivery date
    Example: "01/13/2025"

  - `data.rates.transit_days_min` (integer)
    Minimum transit days
    Example: 8

  - `data.rates.transit_days_max` (integer)
    Maximum transit days
    Example: 8

  - `data.rates.services` (object)
    Details of the services offered

  - `data.rates.services.name` (string)
    Name of the service
    Example: "STANDARD"

  - `data.rates.services.description` (string)
    Description of the service
    Example: "STANDARD"

  - `data.premium` (number)
    Example: 1221

  - `data.quote_number` (string)
    Example: "unique-quote-number"

## Response 400 fields (application/json):

  - `message` (string)
    Example: "INVALID REQUEST."

## Response 401 fields (application/json):

  - `message` (string)
    Example: "Unauthenticated."

## Response 500 fields (application/json):

  - `message` (string)
    Example: "Internal server error"