---
title: "Query for rate quotes."
method: POST
path: "/api/v4/ltl/quotes/rates/query"
tags: ["LTL: Quotes"]
---

# Query for rate quotes.

`POST /api/v4/ltl/quotes/rates/query`

## Request

- Base URL: `https://na12.api.project44.com`
- URL: `https://na12.api.project44.com/api/v4/ltl/quotes/rates/query`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/api/v4/oauth2/token`
- TypeScript: <https://skmtc.dev/project44/apis/project44-rest-api/docs/api/v4/ltl/quotes/rates/query/post.ts> (a function with typed inputs; its response is checked against the schema)

<h4>Required Fields</h4>
<ul><li><b>originAddress:</b><ul><li> postalCode </li></ul></li><li><b>destinationAddress:</b><ul><li> postalCode </li></ul></li><li>At least one of <b>lineItems</b> or <b>enhancedHandlingUnits</b> must be provided. Passing both is also accepted.<ul><li><b>lineItems:</b><ul><li> totalWeight </li><li><b>packageDimensions:</b><ul><li> length </li><li> width </li><li> height </li></ul></li><li> freightClass </li></ul></li><li><b>enhancedHandlingUnits:</b> <u>please contact your account manager at project44 before using this field.</u><ul><li> weightPerHandlingUnit </li><li> pickupStopNumber </li><li> deliveryStopNumber </li><li><b>handlingUnitDimensions:</b><ul><li> length </li><li> width </li><li> height </li></ul></li><li> freightClasses </li></ul></li></ul></li></ul><h4>Error Messages</h4><p>A <code>200</code> response can include carriers that failed. Each failed element of <code>rateQuotes</code> carries an <code>errorMessages</code> list. Every message in that list may include an <code>errorCode</code>: the normalized project44 error code, identical across capacity providers, so integrations can branch on it instead of parsing the carrier-specific <code>message</code> or <code>diagnostic</code>. <code>errorCode</code> is omitted when no code is available. Clients must tolerate this additional field.</p>

## Request body

- RateQuoteQuery: A request for rate quotes from one or more capacity providers based on the provided shipment characteristics and location information.
  - `accessorialServices` AccessorialService[]: List of accessorial services to be quoted for this shipment.
    - `code` string: The code for the requested accessorial service. A list of accessorial service codes supported by project44 is provided in the API reference data section.
  - `apiConfiguration` RateQuoteApiConfiguration: Contains fields used to configure the rate quote API.
    - `accessorialServiceConfiguration` AccessorialServiceConfiguration: Contains fields used to configure the rate quote accessorial services.
      - `allowUnacceptedAccessorials` boolean: If set to 'true', rate quotes will be allowed from capacity providers that do not accept one or more requested accessorial services. The default behavior is to reject a rate quote with an error from any capacity provider that does not accept every requested accessorial service in the query. (default: 'false')
      - `fetchAllGuaranteed` boolean: If set to 'true', rate quotes for all possible guaranteed service levels (e.g., guaranteed by noon or guaranteed by 3pm) will be retrieved from each capacity provider, based on what each provider offers. (default: 'false')
      - `fetchAllInsideDelivery` boolean: If set to 'true', rate quotes for all possible inside delivery accessorial services will be retrieved from each capacity provider, based on what each provider offers. (default: 'false')
      - `fetchAllServiceLevels` boolean: If set to 'true', rate quotes for all possible service levels (e.g., guaranteed or expedited) will be retrieved from each capacity provider, based on what each provider offers. (default: 'false')
    - `enableUnitConversion` boolean: If set to 'true', weight and length values in this rate quote query will be converted when necessary to the capacity provider's supported units. When 'false', an error will be returned for each capacity provider that does not support the provided weight and length units. (default: 'false')
    - `fallBackToDefaultAccountGroup` boolean: If set to 'true' and the provided capacity provider account group code is invalid, the default capacity provider account group will be used. When 'false', an error will be returned if the provided capacity provider account group code is invalid. (default: 'false')
    - `timeout` integer: Number of seconds to wait for a capacity provider to return a rate quote. The max effective value is 60 seconds. (default: '15')
  - `capacityProviderAccountGroup` CapacityProviderAccountGroup: The requested capacity provider account group containing the account used for authentication with the capacity provider's API.
    - `accounts` CapacityProviderAccount[]: Capacity provider accounts used for authentication with the capacity providers' APIs. For quoting, defaults to all accounts within the account group. For shipment, shipment status, and image, one and only one account is required.
      - `code` string: The code for the requested capacity provider account that was used for authentication with the capacity provider's API.
    - `code` string: The code for the capacity provider account group that contains all accounts against which an operation is to be performed. Capacity provider account groups are set up through the project44 Self-Service Portal. If no key is specified, the 'Default' account group will be used.
  - `deliveryWindow` LocalDateTimeWindow: A date and time range, local to the applicable location, representing a window of availability.
    - `date` string, date: Date for this time window in the timezone of the applicable location.(default: current date, format: yyyy-MM-dd)
    - `endTime` string: End time of this window in the timezone of the applicable location. (format: HH:mm)
    - `startTime` string: Start time of this window in the timezone of the applicable location. (format: HH:mm)
  - `destinationAddress` Address: A postal address.
    - `addressLines` string[]: Street name, number, direction, PO box, etc. Only three address lines are currently permitted.
    - `city` string: Name of city, town, etc.
    - `country` 'US' | 'CA' | 'MX' | 'AG' | 'BB' | 'BS' | 'BZ' | 'CR' | 'CU' | 'DM' | 'DO' | 'GD' | 'GT' | 'HN' | 'HT' | 'JM' | 'KN' | 'LC' | 'NI' | 'PA' | 'SV' | 'TT' | 'VC' | 'AI' | 'AW' | 'BL' | 'BM' | 'BQ' | 'CW' | 'GL' | 'GP' | 'KY' | 'MF' | 'MQ' | 'MS' | 'PM' | 'PR' | 'SX' | 'TC' | 'UM' | 'VG' | 'VI' | 'AT' | 'BE' | 'BG' | 'CY' | 'CZ' | 'DK' | 'DE' | 'EE' | 'ES' | 'FI' | 'FR' | 'GB' | 'GR' | 'HR' | 'HU' | 'IE' | 'IT' | 'LT' | 'LU' | 'LV' | 'MT' | 'NL' | 'PL' | 'PT' | 'RO' | 'SE' | 'SK' | 'SI' | 'CH' | 'IS' | 'LI' | 'NO' | 'AL' | 'ME' | 'MK' | 'RS' | 'TR' | 'AD' | 'AX' | 'BA' | 'BV' | 'BY' | 'FO' | 'GG' | 'GI' | 'IM' | 'IO' | 'JE' | 'MC' | 'MD' | 'SJ' | 'SM' | 'TF' | 'UA' | 'VA' | 'AE' | 'AF' | 'AM' | 'AZ' | 'BD' | 'BH' | 'BN' | 'BT' | 'CN' | 'GE' | 'HK' | 'ID' | 'IL' | 'IN' | 'IQ' | 'IR' | 'JO' | 'JP' | 'KG' | 'KH' | 'KP' | 'KR' | 'KW' | 'KZ' | 'LA' | 'LB' | 'LK' | 'MM' | 'MN' | 'MO' | 'MV' | 'MY' | 'NP' | 'OM' | 'PH' | 'PK' | 'PS' | 'QA' | 'RU' | 'SA' | 'SG' | 'SY' | 'TH' | 'TJ' | 'TL' | 'TM' | 'TW' | 'UZ' | 'VN' | 'YE' | 'AO' | 'BF' | 'BI' | 'BJ' | 'BW' | 'CD' | 'CF' | 'CG' | 'CI' | 'CM' | 'CV' | 'DJ' | 'DZ' | 'EG' | 'EH' | 'ER' | 'ET' | 'GA' | 'GH' | 'GM' | 'GN' | 'GQ' | 'GW' | 'HM' | 'KE' | 'KM' | 'LR' | 'LS' | 'LY' | 'MA' | 'MG' | 'ML' | 'MR' | 'MU' | 'MW' | 'MZ' | 'NA' | 'NE' | 'NG' | 'RE' | 'RW' | 'SC' | 'SD' | 'SH' | 'SL' | 'SN' | 'SO' | 'SS' | 'ST' | 'SZ' | 'TD' | 'TG' | 'TN' | 'TZ' | 'UG' | 'YT' | 'ZA' | 'ZM' | 'ZW' | 'AR' | 'BO' | 'BR' | 'CL' | 'CO' | 'EC' | 'FK' | 'GF' | 'GS' | 'GY' | 'PE' | 'PY' | 'SR' | 'UY' | 'VE' | 'AS' | 'AU' | 'CC' | 'CK' | 'CX' | 'FJ' | 'FM' | 'GU' | 'KI' | 'MH' | 'MP' | 'NC' | 'NF' | 'NR' | 'NU' | 'NZ' | 'PF' | 'PG' | 'PN' | 'PW' | 'SB' | 'TK' | 'TO' | 'TV' | 'VU' | 'WF' | 'WS' | 'AQ' | 'EL' | 'UK' | 'XK' | 'XS' | 'XI', enum: Abbreviation of country (using ISO 3166 standards). (default: 'US')
    - `postalCode` string: The ZIP or postal code.
    - `state` string: Abbreviation of state, province, district, etc.
  - `directionOverride` 'SHIPPER' | 'CONSIGNEE' | 'THIRD_PARTY': An override of direction for all capacity provider accounts used by this request that have 'Enable API override of direction' set as 'true' in the project44 Self-Service Portal.This functionality is typically used in situations where both inbound and outbound shipments are common for a given capacity provider and account number.
  - `enhancedHandlingUnits` HandlingUnit[]: A more granular representation of a line item. Required if no lineItems. Allows for order level tracking, more accurate rates, and more detailed BOLs. Currently not supported by all vendors. An enhancedHandlingUnit consists of one or more handling units, e.g. a pallet or a drum, one or more packages (the container on the handling unit e.g. a box), and package contents. NMFC codes and freight classes can be assigned at the handling unit and package level, while package contents can be associated with a DELIVERY_NUMBER, SKU_NUMBER, or PURCHASE_ORDER_NUMBER. Passing in both this field and lineItems is accepted, but at least one is required.
    - `commodityType` string: This code dictates the duty rating, as well as alerts you to any import or export restrictions.
    - `contact` Contact: Contact information.
      - `companyName` string: Company name.
      - `contactName` string: Contact name. May be required for shipments.
      - `email` string: Email address. May be required for shipments.
      - `faxNumber` string: Fax number. E.164 or North American Number Plan (NANP) phone numbers are accepted. If a phone number is passed in without the associated country code field, the number will be treated as a number that adheres to the NANP standard. The number will be returned in responses in the NANP format: '[+123 ]123-456-7890[, ext. 123456]'. If the associated country code field is passed in as well, the number will be treated as a number that adheres to the E.164 international phone number standard. The number will be returned in a response in the E.164 format: '[+123 ]12345678910[, ext. 123456]'. In requests, only digits and an optional 'X' (or lowercase 'x') marking the start of an extension will be used. Any other characters included for formatting will be stripped -- project44 will provide the phone number to the capacity provider in the format they accept. There must be at least ten digits before the optional 'X' (for the area code, central office code, and station code for NANP numbers or simply the subscriber number for E.164 numbers). For NANP numbers, no more than thirteen, with the first digits exceeding ten being interpreted as the country code when the country code. The number of digits after the optional 'X' must be less than seven. Examples of acceptable NANP phone numbers: '123-456-7890 x 32', '(123)456-7890 ext 30', '1234567890', '11234567890', '+55-123-456-7890 ext. 312412', '123-456-7890, ext. 1234'. In responses, phone numbers will be returned in the following format: '[+123 ]123-456-7890[, ext. 123456]'. Examples of acceptable E.164 phone numbers: '20-1234-5678 x 1234', '(20) 1234-5678x1234', '2012345678', '20 1234-5678 ext 1234'. In responses, phone numbers will be returned in the following format: '[+123 ]2012345678[, ext. 1234]'.
      - `faxNumberCountryCode` string: The country code associated with the phone number. If this is blank, the phone number will be treated as a number that adheres to the North American Number Plan (NANP) format. Acceptable country codes formats: '+123' or '123'.
      - `phoneNumber` string: Phone number. May be required for shipments. E.164 or North American Number Plan (NANP) phone numbers are accepted. If a phone number is passed in without the associated country code field, the number will be treated as a number that adheres to the NANP standard. The number will be returned in responses in the NANP format: '[+123 ]123-456-7890[, ext. 123456]'. If the associated country code field is passed in as well, the number will be treated as a number that adheres to the E.164 international phone number standard. The number will be returned in a response in the E.164 format: '[+123 ]12345678910[, ext. 123456]'. In requests, only digits and an optional 'X' (or lowercase 'x') marking the start of an extension will be used. Any other characters included for formatting will be stripped -- project44 will provide the phone number to the capacity provider in the format they accept. There must be at least ten digits before the optional 'X' (for the area code, central office code, and station code for NANP numbers or simply the subscriber number for E.164 numbers). For NANP numbers, no more than thirteen, with the first digits exceeding ten being interpreted as the country code when the country code. The number of digits after the optional 'X' must be less than seven. Examples of acceptable NANP phone numbers: '123-456-7890 x 32', '(123)456-7890 ext 30', '1234567890', '11234567890', '+55-123-456-7890 ext. 312412', '123-456-7890, ext. 1234'. In responses, phone numbers will be returned in the following format: '[+123 ]123-456-7890[, ext. 123456]'. Examples of acceptable E.164 phone numbers: '20-1234-5678 x 1234', '(20) 1234-5678x1234', '2012345678', '20 1234-5678 ext 1234'. In responses, phone numbers will be returned in the following format: '[+123 ]2012345678[, ext. 1234]'.
      - `phoneNumber2` string: Alternate phone number. E.164 or North American Number Plan (NANP) phone numbers are accepted. If a phone number is passed in without the associated country code field, the number will be treated as a number that adheres to the NANP standard. The number will be returned in responses in the NANP format: '[+123 ]123-456-7890[, ext. 123456]'. If the associated country code field is passed in as well, the number will be treated as a number that adheres to the E.164 international phone number standard. The number will be returned in a response in the E.164 format: '[+123 ]12345678910[, ext. 123456]'. In requests, only digits and an optional 'X' (or lowercase 'x') marking the start of an extension will be used. Any other characters included for formatting will be stripped -- project44 will provide the phone number to the capacity provider in the format they accept. There must be at least ten digits before the optional 'X' (for the area code, central office code, and station code for NANP numbers or simply the subscriber number for E.164 numbers). For NANP numbers, no more than thirteen, with the first digits exceeding ten being interpreted as the country code when the country code. The number of digits after the optional 'X' must be less than seven. Examples of acceptable NANP phone numbers: '123-456-7890 x 32', '(123)456-7890 ext 30', '1234567890', '11234567890', '+55-123-456-7890 ext. 312412', '123-456-7890, ext. 1234'. In responses, phone numbers will be returned in the following format: '[+123 ]123-456-7890[, ext. 123456]'. Examples of acceptable E.164 phone numbers: '20-1234-5678 x 1234', '(20) 1234-5678x1234', '2012345678', '20 1234-5678 ext 1234'. In responses, phone numbers will be returned in the following format: '[+123 ]2012345678[, ext. 1234]'.
      - `phoneNumber2CountryCode` string: The country code associated with the phone number. If this is blank, the phone number will be treated as a number that adheres to the North American Number Plan (NANP) format. Acceptable country codes formats: '+123' or '123'.
      - `phoneNumberCountryCode` string: The country code associated with the phone number. If this is blank, the phone number will be treated as a number that adheres to the North American Number Plan (NANP) format. Acceptable country codes formats: '+123' or '123'.
    - `deliveryStopNumber` integer: A reference to the stop number where this item will be dropped off. For LTL this value should always be 2.
    - `description` string: A brief description of the handling unit and its contents.
    - `freightClasses` string[]: A list of freight classes for this handling unit.
    - `handlingUnitDimensions` CubicDimension: A cubic dimension.
      - `height` number: Height measurement.
      - `length` number: Length measurement.
      - `width` number: Width measurement.
    - `handlingUnitQuantity` integer: The number of handling units identical to this one.
    - `handlingUnitType` 'BAG' | 'BALE' | 'BARREL' | 'BOX' | 'BUCKET' | 'BUNDLE' | 'CAN' | 'CARTON' | 'CASE' | 'COIL' | 'CRATE' | 'CYLINDER' | 'DRUM' | 'PACK' | 'PAIL' | 'PALLET' | 'PIECES' | 'REEL' | 'ROLL' | 'SKID' | 'TOTE' | 'TRAY' | 'TUBE': The type of the handling unit.
    - `harmonizedCode` string: Harmonized System (HS) Code for the product as defined by the World Customers Organization, usually 6 characters in length, but up to 10 characters as defined by customs organizations by country.In the US, this would be the HTS or HTSA Code as defined by the US International Trade Commission.
    - `nmfcCodes` NmfcCode[]: A list of the NMFC codes associated with this shipment.
      - `code` string: NMFC item and sub code. Codes can only contain numeric characters and the '-' character. The item code must be 4 to 6 digits long. The '-' and sub code are optional, but if sub code is included it is 1 to 2 digits long. Must be in format XXXXXX-XX.
    - `packages` Package[]: The packages on/in this handling unit.
      - `contact` Contact: Contact information.
        - `companyName` string: Company name.
        - `contactName` string: Contact name. May be required for shipments.
        - `email` string: Email address. May be required for shipments.
        - `faxNumber` string: Fax number. E.164 or North American Number Plan (NANP) phone numbers are accepted. If a phone number is passed in without the associated country code field, the number will be treated as a number that adheres to the NANP standard. The number will be returned in responses in the NANP format: '[+123 ]123-456-7890[, ext. 123456]'. If the associated country code field is passed in as well, the number will be treated as a number that adheres to the E.164 international phone number standard. The number will be returned in a response in the E.164 format: '[+123 ]12345678910[, ext. 123456]'. In requests, only digits and an optional 'X' (or lowercase 'x') marking the start of an extension will be used. Any other characters included for formatting will be stripped -- project44 will provide the phone number to the capacity provider in the format they accept. There must be at least ten digits before the optional 'X' (for the area code, central office code, and station code for NANP numbers or simply the subscriber number for E.164 numbers). For NANP numbers, no more than thirteen, with the first digits exceeding ten being interpreted as the country code when the country code. The number of digits after the optional 'X' must be less than seven. Examples of acceptable NANP phone numbers: '123-456-7890 x 32', '(123)456-7890 ext 30', '1234567890', '11234567890', '+55-123-456-7890 ext. 312412', '123-456-7890, ext. 1234'. In responses, phone numbers will be returned in the following format: '[+123 ]123-456-7890[, ext. 123456]'. Examples of acceptable E.164 phone numbers: '20-1234-5678 x 1234', '(20) 1234-5678x1234', '2012345678', '20 1234-5678 ext 1234'. In responses, phone numbers will be returned in the following format: '[+123 ]2012345678[, ext. 1234]'.
        - `faxNumberCountryCode` string: The country code associated with the phone number. If this is blank, the phone number will be treated as a number that adheres to the North American Number Plan (NANP) format. Acceptable country codes formats: '+123' or '123'.
        - `phoneNumber` string: Phone number. May be required for shipments. E.164 or North American Number Plan (NANP) phone numbers are accepted. If a phone number is passed in without the associated country code field, the number will be treated as a number that adheres to the NANP standard. The number will be returned in responses in the NANP format: '[+123 ]123-456-7890[, ext. 123456]'. If the associated country code field is passed in as well, the number will be treated as a number that adheres to the E.164 international phone number standard. The number will be returned in a response in the E.164 format: '[+123 ]12345678910[, ext. 123456]'. In requests, only digits and an optional 'X' (or lowercase 'x') marking the start of an extension will be used. Any other characters included for formatting will be stripped -- project44 will provide the phone number to the capacity provider in the format they accept. There must be at least ten digits before the optional 'X' (for the area code, central office code, and station code for NANP numbers or simply the subscriber number for E.164 numbers). For NANP numbers, no more than thirteen, with the first digits exceeding ten being interpreted as the country code when the country code. The number of digits after the optional 'X' must be less than seven. Examples of acceptable NANP phone numbers: '123-456-7890 x 32', '(123)456-7890 ext 30', '1234567890', '11234567890', '+55-123-456-7890 ext. 312412', '123-456-7890, ext. 1234'. In responses, phone numbers will be returned in the following format: '[+123 ]123-456-7890[, ext. 123456]'. Examples of acceptable E.164 phone numbers: '20-1234-5678 x 1234', '(20) 1234-5678x1234', '2012345678', '20 1234-5678 ext 1234'. In responses, phone numbers will be returned in the following format: '[+123 ]2012345678[, ext. 1234]'.
        - `phoneNumber2` string: Alternate phone number. E.164 or North American Number Plan (NANP) phone numbers are accepted. If a phone number is passed in without the associated country code field, the number will be treated as a number that adheres to the NANP standard. The number will be returned in responses in the NANP format: '[+123 ]123-456-7890[, ext. 123456]'. If the associated country code field is passed in as well, the number will be treated as a number that adheres to the E.164 international phone number standard. The number will be returned in a response in the E.164 format: '[+123 ]12345678910[, ext. 123456]'. In requests, only digits and an optional 'X' (or lowercase 'x') marking the start of an extension will be used. Any other characters included for formatting will be stripped -- project44 will provide the phone number to the capacity provider in the format they accept. There must be at least ten digits before the optional 'X' (for the area code, central office code, and station code for NANP numbers or simply the subscriber number for E.164 numbers). For NANP numbers, no more than thirteen, with the first digits exceeding ten being interpreted as the country code when the country code. The number of digits after the optional 'X' must be less than seven. Examples of acceptable NANP phone numbers: '123-456-7890 x 32', '(123)456-7890 ext 30', '1234567890', '11234567890', '+55-123-456-7890 ext. 312412', '123-456-7890, ext. 1234'. In responses, phone numbers will be returned in the following format: '[+123 ]123-456-7890[, ext. 123456]'. Examples of acceptable E.164 phone numbers: '20-1234-5678 x 1234', '(20) 1234-5678x1234', '2012345678', '20 1234-5678 ext 1234'. In responses, phone numbers will be returned in the following format: '[+123 ]2012345678[, ext. 1234]'.
        - `phoneNumber2CountryCode` string: The country code associated with the phone number. If this is blank, the phone number will be treated as a number that adheres to the North American Number Plan (NANP) format. Acceptable country codes formats: '+123' or '123'.
        - `phoneNumberCountryCode` string: The country code associated with the phone number. If this is blank, the phone number will be treated as a number that adheres to the North American Number Plan (NANP) format. Acceptable country codes formats: '+123' or '123'.
      - `description` string: A brief description of the package and its contents.
      - `freightClass` '50' | '55' | '60' | '65' | '70' | '77.5' | '85' | '92.5' | '100' | '110' | '125' | '150' | '175' | '200' | '250' | '300' | '400' | '500': The freight class in this package.
      - `involvedParties` Party[]: A list of parties and their identifiers related to the line item. These are your customers receiving this line item or your suppliers providing this line item.
        - `addressInfo` PartyAddress: A postal address.
          - `addressLines` string[]: Street name, number, direction, PO box, etc. Only three address lines are currently permitted.
          - `addressLabel` string: The project44-generated label for the address persisted in location-service.
          - `city` string: Name of city, town, etc.
          - `country` 'US' | 'CA' | 'MX' | 'AG' | 'BB' | 'BS' | 'BZ' | 'CR' | 'CU' | 'DM' | 'DO' | 'GD' | 'GT' | 'HN' | 'HT' | 'JM' | 'KN' | 'LC' | 'NI' | 'PA' | 'SV' | 'TT' | 'VC' | 'AI' | 'AW' | 'BL' | 'BM' | 'BQ' | 'CW' | 'GL' | 'GP' | 'KY' | 'MF' | 'MQ' | 'MS' | 'PM' | 'PR' | 'SX' | 'TC' | 'UM' | 'VG' | 'VI' | 'AT' | 'BE' | 'BG' | 'CY' | 'CZ' | 'DK' | 'DE' | 'EE' | 'ES' | 'FI' | 'FR' | 'GB' | 'GR' | 'HR' | 'HU' | 'IE' | 'IT' | 'LT' | 'LU' | 'LV' | 'MT' | 'NL' | 'PL' | 'PT' | 'RO' | 'SE' | 'SK' | 'SI' | 'CH' | 'IS' | 'LI' | 'NO' | 'AL' | 'ME' | 'MK' | 'RS' | 'TR' | 'AD' | 'AX' | 'BA' | 'BV' | 'BY' | 'FO' | 'GG' | 'GI' | 'IM' | 'IO' | 'JE' | 'MC' | 'MD' | 'SJ' | 'SM' | 'TF' | 'UA' | 'VA' | 'AE' | 'AF' | 'AM' | 'AZ' | 'BD' | 'BH' | 'BN' | 'BT' | 'CN' | 'GE' | 'HK' | 'ID' | 'IL' | 'IN' | 'IQ' | 'IR' | 'JO' | 'JP' | 'KG' | 'KH' | 'KP' | 'KR' | 'KW' | 'KZ' | 'LA' | 'LB' | 'LK' | 'MM' | 'MN' | 'MO' | 'MV' | 'MY' | 'NP' | 'OM' | 'PH' | 'PK' | 'PS' | 'QA' | 'RU' | 'SA' | 'SG' | 'SY' | 'TH' | 'TJ' | 'TL' | 'TM' | 'TW' | 'UZ' | 'VN' | 'YE' | 'AO' | 'BF' | 'BI' | 'BJ' | 'BW' | 'CD' | 'CF' | 'CG' | 'CI' | 'CM' | 'CV' | 'DJ' | 'DZ' | 'EG' | 'EH' | 'ER' | 'ET' | 'GA' | 'GH' | 'GM' | 'GN' | 'GQ' | 'GW' | 'HM' | 'KE' | 'KM' | 'LR' | 'LS' | 'LY' | 'MA' | 'MG' | 'ML' | 'MR' | 'MU' | 'MW' | 'MZ' | 'NA' | 'NE' | 'NG' | 'RE' | 'RW' | 'SC' | 'SD' | 'SH' | 'SL' | 'SN' | 'SO' | 'SS' | 'ST' | 'SZ' | 'TD' | 'TG' | 'TN' | 'TZ' | 'UG' | 'YT' | 'ZA' | 'ZM' | 'ZW' | 'AR' | 'BO' | 'BR' | 'CL' | 'CO' | 'EC' | 'FK' | 'GF' | 'GS' | 'GY' | 'PE' | 'PY' | 'SR' | 'UY' | 'VE' | 'AS' | 'AU' | 'CC' | 'CK' | 'CX' | 'FJ' | 'FM' | 'GU' | 'KI' | 'MH' | 'MP' | 'NC' | 'NF' | 'NR' | 'NU' | 'NZ' | 'PF' | 'PG' | 'PN' | 'PW' | 'SB' | 'TK' | 'TO' | 'TV' | 'VU' | 'WF' | 'WS' | 'AQ' | 'EL' | 'UK' | 'XK' | 'XS' | 'XI', enum: Abbreviation of country (using ISO 3166 standards). (default: 'US')
          - `id` string, uuid: The project44-generated identifier for the address persisted in location-service.
          - `postalCode` string: The ZIP or postal code.
          - `state` string: Abbreviation of state, province, district, etc.
        - `contactInfo` BookingContact
          - `companyName` string: Name of the Company with whom the Contact is associated.
          - `email` string, email: The Contact's email address.
          - `familyName` string: The Contact's last or family name.
          - `givenName` string: The Contact's first or given name.
          - `mobilePhoneNumber` string: The Contact's mobile phone number.
          - `phoneNumber` string: The Contact's work or other primary phone number.
        - `identifyingCodes` IdentifyingCodes
          - `codeListProvider` 'WAVE' | 'CARX' | 'ESSD' | 'IDT' | 'BOLE' | 'EDOX' | 'IQAX' | 'SECR' | 'TRGO' | 'ETEU' | 'TRAC' | 'BRIT' | 'GSBN' | 'WISE' | 'GLEIF' | 'W3C' | 'DNB' | 'FMC' | 'DCSA' | 'ZZZ': An enumeration.
          - `codeListName` 'DID' | 'LEI' | 'DUNS': An enumeration.
          - `partyCode` string: Code to identify the party as provided by the code list provider
        - `locationIdentifiers` RatingLocationIdentifier[]: Identifiers for the location of the party.
          - `type` 'UNKNOWN' | 'AIRPORT_IATA' | 'AIRPORT_ICAO' | 'PORT_UN_LOCODE' | 'RAIL_SPLC' | 'DATA_PROVIDER_LOCATION_CODE' | 'LOCODE': An enumeration.
          - `value` string
        - `partyType` 'SHIPPER' | 'CONSIGNEE' | 'BILL_TO' | 'NOTIFY_PARTY' | 'BOOKING_AGENT' | 'CARRIER_BOOKING_OFFICE': An enumeration.
        - `vatNumber` string: Optional, VAT number of the listed party, if applicable.
      - `nmfcCodes` NmfcCode[]: A list of the NMFC codes associated with this shipment.
        - `code` string: NMFC item and sub code. Codes can only contain numeric characters and the '-' character. The item code must be 4 to 6 digits long. The '-' and sub code are optional, but if sub code is included it is 1 to 2 digits long. Must be in format XXXXXX-XX.
      - `packageContainerType` 'BAG' | 'BALE' | 'BOX' | 'BUCKET' | 'PAIL' | 'BUNDLE' | 'CAN' | 'CARTON' | 'CASE' | 'COIL' | 'CRATE' | 'CYLINDER' | 'EACH' | 'FLAT' | 'LOOSE' | 'ROLL' | 'TUBE': The type of the package.
      - `packageContents` PackageContents[]: A description of the items contained in the package.
        - `countryOfManufacture` 'US' | 'CA' | 'MX' | 'AG' | 'BB' | 'BS' | 'BZ' | 'CR' | 'CU' | 'DM' | 'DO' | 'GD' | 'GT' | 'HN' | 'HT' | 'JM' | 'KN' | 'LC' | 'NI' | 'PA' | 'SV' | 'TT' | 'VC' | 'AI' | 'AW' | 'BL' | 'BM' | 'BQ' | 'CW' | 'GL' | 'GP' | 'KY' | 'MF' | 'MQ' | 'MS' | 'PM' | 'PR' | 'SX' | 'TC' | 'UM' | 'VG' | 'VI' | 'AT' | 'BE' | 'BG' | 'CY' | 'CZ' | 'DK' | 'DE' | 'EE' | 'ES' | 'FI' | 'FR' | 'GB' | 'GR' | 'HR' | 'HU' | 'IE' | 'IT' | 'LT' | 'LU' | 'LV' | 'MT' | 'NL' | 'PL' | 'PT' | 'RO' | 'SE' | 'SK' | 'SI' | 'CH' | 'IS' | 'LI' | 'NO' | 'AL' | 'ME' | 'MK' | 'RS' | 'TR' | 'AD' | 'AX' | 'BA' | 'BV' | 'BY' | 'FO' | 'GG' | 'GI' | 'IM' | 'IO' | 'JE' | 'MC' | 'MD' | 'SJ' | 'SM' | 'TF' | 'UA' | 'VA' | 'AE' | 'AF' | 'AM' | 'AZ' | 'BD' | 'BH' | 'BN' | 'BT' | 'CN' | 'GE' | 'HK' | 'ID' | 'IL' | 'IN' | 'IQ' | 'IR' | 'JO' | 'JP' | 'KG' | 'KH' | 'KP' | 'KR' | 'KW' | 'KZ' | 'LA' | 'LB' | 'LK' | 'MM' | 'MN' | 'MO' | 'MV' | 'MY' | 'NP' | 'OM' | 'PH' | 'PK' | 'PS' | 'QA' | 'RU' | 'SA' | 'SG' | 'SY' | 'TH' | 'TJ' | 'TL' | 'TM' | 'TW' | 'UZ' | 'VN' | 'YE' | 'AO' | 'BF' | 'BI' | 'BJ' | 'BW' | 'CD' | 'CF' | 'CG' | 'CI' | 'CM' | 'CV' | 'DJ' | 'DZ' | 'EG' | 'EH' | 'ER' | 'ET' | 'GA' | 'GH' | 'GM' | 'GN' | 'GQ' | 'GW' | 'HM' | 'KE' | 'KM' | 'LR' | 'LS' | 'LY' | 'MA' | 'MG' | 'ML' | 'MR' | 'MU' | 'MW' | 'MZ' | 'NA' | 'NE' | 'NG' | 'RE' | 'RW' | 'SC' | 'SD' | 'SH' | 'SL' | 'SN' | 'SO' | 'SS' | 'ST' | 'SZ' | 'TD' | 'TG' | 'TN' | 'TZ' | 'UG' | 'YT' | 'ZA' | 'ZM' | 'ZW' | 'AR' | 'BO' | 'BR' | 'CL' | 'CO' | 'EC' | 'FK' | 'GF' | 'GS' | 'GY' | 'PE' | 'PY' | 'SR' | 'UY' | 'VE' | 'AS' | 'AU' | 'CC' | 'CK' | 'CX' | 'FJ' | 'FM' | 'GU' | 'KI' | 'MH' | 'MP' | 'NC' | 'NF' | 'NR' | 'NU' | 'NZ' | 'PF' | 'PG' | 'PN' | 'PW' | 'SB' | 'TK' | 'TO' | 'TV' | 'VU' | 'WF' | 'WS' | 'AQ' | 'EL' | 'UK' | 'XK' | 'XS' | 'XI': Country of manufacture of line item.
        - `description` string: A brief description of the contents.
        - `hazmatDetails` HazmatDetails[]: Required if the contents are hazardous materials. Provides important information about the hazardous materials to be transported, as required by the US Department of Transportation (DOT).
          - `code` string: The hazard class number, according to the classification system outlined by the FederalMotor Carrier Safety Administration (FMCSA). This is a one digit number or a two digit number separated by a decimal.
          - `emergencyContact` Contact: Contact information.
            - `companyName` string: Company name.
            - `contactName` string: Contact name. May be required for shipments.
            - `email` string: Email address. May be required for shipments.
            - `faxNumber` string: Fax number. E.164 or North American Number Plan (NANP) phone numbers are accepted. If a phone number is passed in without the associated country code field, the number will be treated as a number that adheres to the NANP standard. The number will be returned in responses in the NANP format: '[+123 ]123-456-7890[, ext. 123456]'. If the associated country code field is passed in as well, the number will be treated as a number that adheres to the E.164 international phone number standard. The number will be returned in a response in the E.164 format: '[+123 ]12345678910[, ext. 123456]'. In requests, only digits and an optional 'X' (or lowercase 'x') marking the start of an extension will be used. Any other characters included for formatting will be stripped -- project44 will provide the phone number to the capacity provider in the format they accept. There must be at least ten digits before the optional 'X' (for the area code, central office code, and station code for NANP numbers or simply the subscriber number for E.164 numbers). For NANP numbers, no more than thirteen, with the first digits exceeding ten being interpreted as the country code when the country code. The number of digits after the optional 'X' must be less than seven. Examples of acceptable NANP phone numbers: '123-456-7890 x 32', '(123)456-7890 ext 30', '1234567890', '11234567890', '+55-123-456-7890 ext. 312412', '123-456-7890, ext. 1234'. In responses, phone numbers will be returned in the following format: '[+123 ]123-456-7890[, ext. 123456]'. Examples of acceptable E.164 phone numbers: '20-1234-5678 x 1234', '(20) 1234-5678x1234', '2012345678', '20 1234-5678 ext 1234'. In responses, phone numbers will be returned in the following format: '[+123 ]2012345678[, ext. 1234]'.
            - `faxNumberCountryCode` string: The country code associated with the phone number. If this is blank, the phone number will be treated as a number that adheres to the North American Number Plan (NANP) format. Acceptable country codes formats: '+123' or '123'.
            - `phoneNumber` string: Phone number. May be required for shipments. E.164 or North American Number Plan (NANP) phone numbers are accepted. If a phone number is passed in without the associated country code field, the number will be treated as a number that adheres to the NANP standard. The number will be returned in responses in the NANP format: '[+123 ]123-456-7890[, ext. 123456]'. If the associated country code field is passed in as well, the number will be treated as a number that adheres to the E.164 international phone number standard. The number will be returned in a response in the E.164 format: '[+123 ]12345678910[, ext. 123456]'. In requests, only digits and an optional 'X' (or lowercase 'x') marking the start of an extension will be used. Any other characters included for formatting will be stripped -- project44 will provide the phone number to the capacity provider in the format they accept. There must be at least ten digits before the optional 'X' (for the area code, central office code, and station code for NANP numbers or simply the subscriber number for E.164 numbers). For NANP numbers, no more than thirteen, with the first digits exceeding ten being interpreted as the country code when the country code. The number of digits after the optional 'X' must be less than seven. Examples of acceptable NANP phone numbers: '123-456-7890 x 32', '(123)456-7890 ext 30', '1234567890', '11234567890', '+55-123-456-7890 ext. 312412', '123-456-7890, ext. 1234'. In responses, phone numbers will be returned in the following format: '[+123 ]123-456-7890[, ext. 123456]'. Examples of acceptable E.164 phone numbers: '20-1234-5678 x 1234', '(20) 1234-5678x1234', '2012345678', '20 1234-5678 ext 1234'. In responses, phone numbers will be returned in the following format: '[+123 ]2012345678[, ext. 1234]'.
            - `phoneNumber2` string: Alternate phone number. E.164 or North American Number Plan (NANP) phone numbers are accepted. If a phone number is passed in without the associated country code field, the number will be treated as a number that adheres to the NANP standard. The number will be returned in responses in the NANP format: '[+123 ]123-456-7890[, ext. 123456]'. If the associated country code field is passed in as well, the number will be treated as a number that adheres to the E.164 international phone number standard. The number will be returned in a response in the E.164 format: '[+123 ]12345678910[, ext. 123456]'. In requests, only digits and an optional 'X' (or lowercase 'x') marking the start of an extension will be used. Any other characters included for formatting will be stripped -- project44 will provide the phone number to the capacity provider in the format they accept. There must be at least ten digits before the optional 'X' (for the area code, central office code, and station code for NANP numbers or simply the subscriber number for E.164 numbers). For NANP numbers, no more than thirteen, with the first digits exceeding ten being interpreted as the country code when the country code. The number of digits after the optional 'X' must be less than seven. Examples of acceptable NANP phone numbers: '123-456-7890 x 32', '(123)456-7890 ext 30', '1234567890', '11234567890', '+55-123-456-7890 ext. 312412', '123-456-7890, ext. 1234'. In responses, phone numbers will be returned in the following format: '[+123 ]123-456-7890[, ext. 123456]'. Examples of acceptable E.164 phone numbers: '20-1234-5678 x 1234', '(20) 1234-5678x1234', '2012345678', '20 1234-5678 ext 1234'. In responses, phone numbers will be returned in the following format: '[+123 ]2012345678[, ext. 1234]'.
            - `phoneNumber2CountryCode` string: The country code associated with the phone number. If this is blank, the phone number will be treated as a number that adheres to the North American Number Plan (NANP) format. Acceptable country codes formats: '+123' or '123'.
            - `phoneNumberCountryCode` string: The country code associated with the phone number. If this is blank, the phone number will be treated as a number that adheres to the North American Number Plan (NANP) format. Acceptable country codes formats: '+123' or '123'.
          - `identificationNumber` string: The United Nations (UN) or North America (NA) number identifying the hazmat item.
          - `packingGroup` 'I' | 'II' | 'III' | 'NONE': The hazmat packing group for a line item, indicating the degree of danger.
          - `properShippingName` string: The proper shipping name of the hazmat item.
        - `packageContentIdentifiers` PackageContentIdentifier[]: The identifiers associated with the contents.
          - `type` 'PURCHASE_ORDER_NUMBER' | 'SKU_NUMBER' | 'DELIVERY_NUMBER': The type of the package content identifier.
          - `value` string: The value of the package content identifier.
        - `packageContentQuantity` integer: The number of items contained in the package.
      - `packageDimensions` CubicDimension: A cubic dimension.
        - `height` number: Height measurement.
        - `length` number: Length measurement.
        - `width` number: Width measurement.
      - `packageQuantity` integer: The number of packages on the handling unit identical to this one.
      - `weightPerPackage` number: Weight per package.
    - `pickupStopNumber` integer: A reference to the stop number where this item will be picked up. For LTL this value should always be 1
    - `stackable` boolean: True false value indicating whether or not the handling units can be stacked
    - `totalValue` MonetaryValue: A monetary value expressing amount and currency type.
      - `amount` number: The value of the shipment
      - `currency` 'USD' | 'CAD' | 'MXN' | 'EUR', enum: The currency of the shipment value
    - `weightPerHandlingUnit` number: Weight per handling unit.
  - `lengthUnit` 'IN' | 'CM' | 'FT' | 'M': Length measurement unit for all length values in this rate quote query. (default: 'IN')
  - `lineItems` LineItem[]: The line items composing the shipment to be quoted. A line item consists of one or more packages, all of the same package type and with the same dimensions, freight class, and NMFC code. Each package, however, may have a different number of pieces and a different weight. Note that each capacity provider has a different maximum number of line items that they can quote. NOTE: This field is similar to, but not the same as, the enhancedHandlingUnits field. The handling units fields can contain more detailed information for use by both the carrier and the shipper. Passing in both this field and enhancedHandlingUnit is accepted, but at least one is required.
    - `commodityType` string: Commodity code identifying the type of shipment. Required for insurance quotes.
    - `countryOfManufacture` 'US' | 'CA' | 'MX' | 'AG' | 'BB' | 'BS' | 'BZ' | 'CR' | 'CU' | 'DM' | 'DO' | 'GD' | 'GT' | 'HN' | 'HT' | 'JM' | 'KN' | 'LC' | 'NI' | 'PA' | 'SV' | 'TT' | 'VC' | 'AI' | 'AW' | 'BL' | 'BM' | 'BQ' | 'CW' | 'GL' | 'GP' | 'KY' | 'MF' | 'MQ' | 'MS' | 'PM' | 'PR' | 'SX' | 'TC' | 'UM' | 'VG' | 'VI' | 'AT' | 'BE' | 'BG' | 'CY' | 'CZ' | 'DK' | 'DE' | 'EE' | 'ES' | 'FI' | 'FR' | 'GB' | 'GR' | 'HR' | 'HU' | 'IE' | 'IT' | 'LT' | 'LU' | 'LV' | 'MT' | 'NL' | 'PL' | 'PT' | 'RO' | 'SE' | 'SK' | 'SI' | 'CH' | 'IS' | 'LI' | 'NO' | 'AL' | 'ME' | 'MK' | 'RS' | 'TR' | 'AD' | 'AX' | 'BA' | 'BV' | 'BY' | 'FO' | 'GG' | 'GI' | 'IM' | 'IO' | 'JE' | 'MC' | 'MD' | 'SJ' | 'SM' | 'TF' | 'UA' | 'VA' | 'AE' | 'AF' | 'AM' | 'AZ' | 'BD' | 'BH' | 'BN' | 'BT' | 'CN' | 'GE' | 'HK' | 'ID' | 'IL' | 'IN' | 'IQ' | 'IR' | 'JO' | 'JP' | 'KG' | 'KH' | 'KP' | 'KR' | 'KW' | 'KZ' | 'LA' | 'LB' | 'LK' | 'MM' | 'MN' | 'MO' | 'MV' | 'MY' | 'NP' | 'OM' | 'PH' | 'PK' | 'PS' | 'QA' | 'RU' | 'SA' | 'SG' | 'SY' | 'TH' | 'TJ' | 'TL' | 'TM' | 'TW' | 'UZ' | 'VN' | 'YE' | 'AO' | 'BF' | 'BI' | 'BJ' | 'BW' | 'CD' | 'CF' | 'CG' | 'CI' | 'CM' | 'CV' | 'DJ' | 'DZ' | 'EG' | 'EH' | 'ER' | 'ET' | 'GA' | 'GH' | 'GM' | 'GN' | 'GQ' | 'GW' | 'HM' | 'KE' | 'KM' | 'LR' | 'LS' | 'LY' | 'MA' | 'MG' | 'ML' | 'MR' | 'MU' | 'MW' | 'MZ' | 'NA' | 'NE' | 'NG' | 'RE' | 'RW' | 'SC' | 'SD' | 'SH' | 'SL' | 'SN' | 'SO' | 'SS' | 'ST' | 'SZ' | 'TD' | 'TG' | 'TN' | 'TZ' | 'UG' | 'YT' | 'ZA' | 'ZM' | 'ZW' | 'AR' | 'BO' | 'BR' | 'CL' | 'CO' | 'EC' | 'FK' | 'GF' | 'GS' | 'GY' | 'PE' | 'PY' | 'SR' | 'UY' | 'VE' | 'AS' | 'AU' | 'CC' | 'CK' | 'CX' | 'FJ' | 'FM' | 'GU' | 'KI' | 'MH' | 'MP' | 'NC' | 'NF' | 'NR' | 'NU' | 'NZ' | 'PF' | 'PG' | 'PN' | 'PW' | 'SB' | 'TK' | 'TO' | 'TV' | 'VU' | 'WF' | 'WS' | 'AQ' | 'EL' | 'UK' | 'XK' | 'XS' | 'XI': Country of manufacture of line item.
    - `description` string: Readable description of this line item.
    - `freightClass` '50' | '55' | '60' | '65' | '70' | '77.5' | '85' | '92.5' | '100' | '110' | '125' | '150' | '175' | '200' | '250' | '300' | '400' | '500': Freight class of all packages composing this item. Required for LTL quotes and shipments only.
    - `harmonizedCode` string: Harmonized System (HS) Code for the product as defined by the World Customers Organization, usually 6 characters in length, but up to 10 characters as defined by customs organizations by country. In the US, this would be the HTS or HTSA Code as defined by the US International Trade Commission.
    - `hazmatDetail` LineItemHazmatDetail: Provides important information about the hazardous materials to be transported, as required by the US Department of Transportation (DOT). Only required for shipment requests.
      - `hazardClass` string: The hazard class number, according to the classification system outlined by the Federal Motor Carrier Safety Administration (FMCSA). This is a one digit number or a two digit number separated by a decimal.
      - `identificationNumber` string: The United Nations (UN) or North America (NA) number identifying the hazmat item.
      - `packingGroup` 'I' | 'II' | 'III' | 'NONE': The hazmat packing group for a line item, indicating the degree of danger.
      - `properShippingName` string: The proper shipping name of the hazmat item.
    - `id` integer: The internal p44 id assigned to this line item. Provided only for insurance line items.
    - `insuranceAmount` number: The insurance amount claim of all pieces of the line item. Required for insurance quotes.
    - `nmfcItemCode` string: NMFC prefix code for all packages composing this line item.
    - `nmfcSubCode` string: NMFC suffix code for all packages composing this line item.
    - `packageDimensions` CubicDimension: A cubic dimension.
      - `height` number: Height measurement.
      - `length` number: Length measurement.
      - `width` number: Width measurement.
    - `packageType` 'BAG' | 'BALE' | 'BOX' | 'BUCKET' | 'BUNDLE' | 'CAN' | 'CARTON' | 'CASE' | 'COIL' | 'CRATE' | 'CYLINDER' | 'DRUM' | 'PAIL' | 'PLT' | 'PIECES' | 'REEL' | 'ROLL' | 'SKID' | 'TOTE' | 'TUBE' | 'EACH' | 'FLAT' | 'LOOSE': Type of packages composing this line item. (default: 'PLT')
    - `stackable` boolean: Whether the packages composing this line item are stackable. (default: 'false')
    - `totalPackages` integer: The number of packages composing this line item. (default: '1')
    - `totalPieces` integer: The total number of pieces across all packages composing this line item. (default: '1')
    - `totalValue` number: The total value of all pieces of the line item. Required for insurance quotes.
    - `totalWeight` number: Total weight of all packages composing this line item.
  - `originAddress` Address: A postal address.
    - `addressLines` string[]: Street name, number, direction, PO box, etc. Only three address lines are currently permitted.
    - `city` string: Name of city, town, etc.
    - `country` 'US' | 'CA' | 'MX' | 'AG' | 'BB' | 'BS' | 'BZ' | 'CR' | 'CU' | 'DM' | 'DO' | 'GD' | 'GT' | 'HN' | 'HT' | 'JM' | 'KN' | 'LC' | 'NI' | 'PA' | 'SV' | 'TT' | 'VC' | 'AI' | 'AW' | 'BL' | 'BM' | 'BQ' | 'CW' | 'GL' | 'GP' | 'KY' | 'MF' | 'MQ' | 'MS' | 'PM' | 'PR' | 'SX' | 'TC' | 'UM' | 'VG' | 'VI' | 'AT' | 'BE' | 'BG' | 'CY' | 'CZ' | 'DK' | 'DE' | 'EE' | 'ES' | 'FI' | 'FR' | 'GB' | 'GR' | 'HR' | 'HU' | 'IE' | 'IT' | 'LT' | 'LU' | 'LV' | 'MT' | 'NL' | 'PL' | 'PT' | 'RO' | 'SE' | 'SK' | 'SI' | 'CH' | 'IS' | 'LI' | 'NO' | 'AL' | 'ME' | 'MK' | 'RS' | 'TR' | 'AD' | 'AX' | 'BA' | 'BV' | 'BY' | 'FO' | 'GG' | 'GI' | 'IM' | 'IO' | 'JE' | 'MC' | 'MD' | 'SJ' | 'SM' | 'TF' | 'UA' | 'VA' | 'AE' | 'AF' | 'AM' | 'AZ' | 'BD' | 'BH' | 'BN' | 'BT' | 'CN' | 'GE' | 'HK' | 'ID' | 'IL' | 'IN' | 'IQ' | 'IR' | 'JO' | 'JP' | 'KG' | 'KH' | 'KP' | 'KR' | 'KW' | 'KZ' | 'LA' | 'LB' | 'LK' | 'MM' | 'MN' | 'MO' | 'MV' | 'MY' | 'NP' | 'OM' | 'PH' | 'PK' | 'PS' | 'QA' | 'RU' | 'SA' | 'SG' | 'SY' | 'TH' | 'TJ' | 'TL' | 'TM' | 'TW' | 'UZ' | 'VN' | 'YE' | 'AO' | 'BF' | 'BI' | 'BJ' | 'BW' | 'CD' | 'CF' | 'CG' | 'CI' | 'CM' | 'CV' | 'DJ' | 'DZ' | 'EG' | 'EH' | 'ER' | 'ET' | 'GA' | 'GH' | 'GM' | 'GN' | 'GQ' | 'GW' | 'HM' | 'KE' | 'KM' | 'LR' | 'LS' | 'LY' | 'MA' | 'MG' | 'ML' | 'MR' | 'MU' | 'MW' | 'MZ' | 'NA' | 'NE' | 'NG' | 'RE' | 'RW' | 'SC' | 'SD' | 'SH' | 'SL' | 'SN' | 'SO' | 'SS' | 'ST' | 'SZ' | 'TD' | 'TG' | 'TN' | 'TZ' | 'UG' | 'YT' | 'ZA' | 'ZM' | 'ZW' | 'AR' | 'BO' | 'BR' | 'CL' | 'CO' | 'EC' | 'FK' | 'GF' | 'GS' | 'GY' | 'PE' | 'PY' | 'SR' | 'UY' | 'VE' | 'AS' | 'AU' | 'CC' | 'CK' | 'CX' | 'FJ' | 'FM' | 'GU' | 'KI' | 'MH' | 'MP' | 'NC' | 'NF' | 'NR' | 'NU' | 'NZ' | 'PF' | 'PG' | 'PN' | 'PW' | 'SB' | 'TK' | 'TO' | 'TV' | 'VU' | 'WF' | 'WS' | 'AQ' | 'EL' | 'UK' | 'XK' | 'XS' | 'XI', enum: Abbreviation of country (using ISO 3166 standards). (default: 'US')
    - `postalCode` string: The ZIP or postal code.
    - `state` string: Abbreviation of state, province, district, etc.
  - `paymentTermsOverride` 'PREPAID' | 'COLLECT' | 'THIRD_PARTY': An override of payment terms for all capacity provider accounts used by this request that have 'Enable API override of payment terms' set as 'true' in the project44 Self-Service Portal. This functionality is typically used in situations where both inbound and outbound shipments are common for a given capacity provider and account number.
  - `pickupWindow` LocalDateTimeWindow: A date and time range, local to the applicable location, representing a window of availability.
    - `date` string, date: Date for this time window in the timezone of the applicable location.(default: current date, format: yyyy-MM-dd)
    - `endTime` string: End time of this window in the timezone of the applicable location. (format: HH:mm)
    - `startTime` string: Start time of this window in the timezone of the applicable location. (format: HH:mm)
  - `preferredCurrency` 'USD' | 'CAD' | 'MXN': The currency that you would like the rate quote to be returned in, other than the default currency the carrier supports. If the currency is supported by the carrier, it will be returned in both the default currency and preferred currency fields. If the carrier does not support the requested currency, we will convert it on behalf of the carrier using the current exchange rate. The preferred currency will be returned in the “preferred currency” fields within the response. The carrier’s original currency will be returned in the default currency fields within the response. Exchange rate information will also be returned in the response for audit purposes.
  - `preferredSystemOfMeasurement` 'METRIC' | 'IMPERIAL': The preferred system of measurement for all values with a unit in this rate quote. The default behavior is to return the unit of measurement specified by the carrier in the response.
  - `totalLinearFeet` integer: The total linear feet that the shipment being quoted will take up in a trailer. Required only for volume LTL shipments. Customers who have enabled our Volume Visualizer product may submit rate requests without providing a value for totalLinearFeet. Linear footage will be automatically calculated, based on line item details, and submitted with your rate request. If a value is provided for totalLinearFeet, it will be submitted with the request and no calculation will be performed.
  - `weightUnit` 'LB' | 'KG': Weight measurement unit for all weight values in this rate quote query. (default: 'LB')

## Response `200`

OK

- RateQuoteCollection: Container for a list of rate quotes returned by a rate quote query.
  - `rateQuotes` RateQuote[]: List of rate quotes from all capacity providers requested.
    - `alternateRateQuotes` AlternateRateQuote[]: A list of alternate rate quotes from this capacity provider, if provided. These are typically rate quotes for other service levels the provider offers (e.g., guaranteed service levels).
      - `capacityProviderQuoteNumber` string: The capacity provider's identifier for this alternate rate quote, if provided.
      - `deliveryDateTime` string, date-time: The delivery date and time for this alternate rate quote in the timezone of the destination location, if provided. (format: yyyy-MM-dd'T'HH:mm:ss)
      - `rateQuoteDetail` RateQuoteDetail: Pricing details for this rate quote, including the total, subtotal, and a breakdown of charges, if provided.
        - `charges` Charge[]: A list of individual charges making up the total, if provided. Not returned for alternate rate quotes.
          - `amount` number: The actual amount charged by the capacity provider (adds into the total). This amount may be negative (e.g., for discounts).
          - `amountInPreferredCurrency` number: A list of individual charges making up the total, if provided, in the preferred currency requested. Also returned for alternate rate quotes.
          - `code` string: Code that identifies this line item charge. A list of charge codes used by project44 is provided in the API reference data section.
          - `description` string: Readable description of the line item charge, often originating from the capacity provider.
          - `itemFreightClass` string: If this is an item charge, the freight class of the line item, if provided. This field is not returned for volume LTL quotes.
          - `itemWeight` number: If this is an item charge, the weight of the line item, if provided. If a preferred system of measurement was provided, the weight will be converted as necessary.
          - `itemWeightUnit` 'LB' | 'KG': If this is an item charge, the weight measurement unit for the provided line item weight. If a preferred system of measurement was provided, the weight will be converted as necessary.
          - `rate` number: Rate used by the capacity provider to calculate this charge (e.g., an amount charged per lb, per piece, per mile, etc.). This rate may be negative (e.g., for discounts).
        - `subtotal` number: Subtotal prior to discounts, if provided.
        - `subtotalInPreferredCurrency` number: Subtotal in preferred currency prior to discounts, if provided.
        - `total` number: The final total for this quote.
        - `totalInPreferredCurrency` number: The final total for this quote, in preferred currency.
      - `serviceLevel` ServiceLevel: The service level offered by the capacity provider (e.g., standard or guaranteed).
        - `code` 'STD' | 'EXPEDITE' | 'EXPEDITE17' | 'EXPEDITEAM' | 'GURWIN' | 'GSSING' | 'GSMUL' | 'GSFM' | 'GS8' | 'GS9' | 'GS10' | 'GS11' | 'GSAM' | 'GS14' | 'GS15' | 'GS1530' | 'GUR' | 'ACCELERATED' | 'CAPLOAD' | 'UNKNOWN': The project44 code for this service level.
        - `description` string: A description of this service level, often originating from the capacity provider.
      - `transitDays` integer: The number of service days to deliver the shipment being quoted after it is picked up, if provided.
      - `transitDaysRange` IntegerRange: Integer Range that contains a maximum and minimum.
        - `max` integer: Maximum integer in this range.
        - `min` integer: Minimum integer in this range.
    - `capacityProviderAccountGroup` CapacityProviderAccountGroup: The requested capacity provider account group containing the account used for authentication with the capacity provider's API.
      - `accounts` CapacityProviderAccount[]: Capacity provider accounts used for authentication with the capacity providers' APIs. For quoting, defaults to all accounts within the account group. For shipment, shipment status, and image, one and only one account is required.
        - `code` string: The code for the requested capacity provider account that was used for authentication with the capacity provider's API.
      - `code` string: The code for the capacity provider account group that contains all accounts against which an operation is to be performed. Capacity provider account groups are set up through the project44 Self-Service Portal. If no key is specified, the 'Default' account group will be used.
    - `capacityProviderQuoteNumber` string: The capacity provider's identifier for this rate quote, if provided.
    - `carrierCode` string: SCAC of the carrier to which this rate quote applies. This is used to differentiate among rate quotes from capacity providers that support multiple SCACs.
    - `contractId` string: This field is returned only for rate quotes from some brokers. It identifies the contract between the broker and capacity provider used to generate this rate quote. This can be used by other brokers or customers to gain access to that rate with the same capacity provider.
    - `currencyCode` 'USD' | 'CAD' | 'MXN' | 'EUR': The currency code for all monetary values in this rate quote.
    - `currencyConversionAuditInfo` CurrencyConversionAuditInfo: Currency conversion metadata.
      - `conversionRate` number: The currency conversion rate applied.
      - `conversionTimestamp` string: The timestamp of the currency conversion.
    - `deliveryDateTime` string, date-time: The delivery date and time for this rate quote in the timezone of the destination location, if provided. (format: yyyy-MM-dd'T'HH:mm:ss)
    - `errorMessages` ErrorMessage[]: System messages and messages from the capacity provider with severity 'ERROR'. No messages with severity 'INFO' or 'WARNING' will be returned here. Each message may include the normalized project44 'errorCode'.
      - `diagnostic` string: Diagnostic information, often originating from the capacity provider.
      - `message` string: Message informational text.
      - `severity` 'ERROR' | 'WARNING' | 'INFO': The severity of this message.
      - `source` 'SYSTEM' | 'CAPACITY_PROVIDER': The originator of this message -- either project44 (the system) or the capacity provider.
      - `errorCode` string: The normalized project44 error code, identical across capacity providers. The capacity provider's own message and diagnostic are still returned in 'message' and 'diagnostic'. Omitted when no code is available.
    - `id` string: The quote ID from project44. This is an optional field
    - `infoMessages` Message[]: System messages and messages from the capacity provider with severity 'INFO' or 'WARNING'. No messages with severity 'ERROR' will be returned here.
      - `diagnostic` string: Diagnostic information, often originating from the capacity provider.
      - `message` string: Message informational text.
      - `severity` 'ERROR' | 'WARNING' | 'INFO': The severity of this message.
      - `source` 'SYSTEM' | 'CAPACITY_PROVIDER': The originator of this message -- either project44 (the system) or the capacity provider.
    - `laneType` 'DIRECT' | 'INTERLINE' | 'UNSPECIFIED': Whether the shipment being quoted will stay within the carrier's network ('DIRECT' for a direct lane) or be tendered to another carrier before reaching its destination ('INTERLINE' for an interline lane), if indicated. (default: 'UNSPECIFIED')
    - `preferredCurrencyCode` 'USD' | 'CAD' | 'MXN' | 'EUR': The currency code preferred for all monetary values with the suffix 'inPreferredCurrency' in this rate quote.
    - `preferredSystemOfMeasurement` 'METRIC' | 'IMPERIAL': The preferred system of measurement for all values with a unit in this rate quote. The default behavior is to return the unit of measurement specified by the carrier in the response.
    - `quoteEffectiveDateTime` string, date-time: The effective date and time for this quote, if provided.(format: yyyy-MM-dd'T'HH:mm:ss)
    - `quoteExpirationDateTime` string, date-time: The date and time this quote expires with the capacity provider, if provided. (format:yyyy-MM-dd'T'HH:mm:ss)
    - `rateQuoteDetail` RateQuoteDetail: Pricing details for this rate quote, including the total, subtotal, and a breakdown of charges, if provided.
      - `charges` Charge[]: A list of individual charges making up the total, if provided. Not returned for alternate rate quotes.
        - `amount` number: The actual amount charged by the capacity provider (adds into the total). This amount may be negative (e.g., for discounts).
        - `amountInPreferredCurrency` number: A list of individual charges making up the total, if provided, in the preferred currency requested. Also returned for alternate rate quotes.
        - `code` string: Code that identifies this line item charge. A list of charge codes used by project44 is provided in the API reference data section.
        - `description` string: Readable description of the line item charge, often originating from the capacity provider.
        - `itemFreightClass` string: If this is an item charge, the freight class of the line item, if provided. This field is not returned for volume LTL quotes.
        - `itemWeight` number: If this is an item charge, the weight of the line item, if provided. If a preferred system of measurement was provided, the weight will be converted as necessary.
        - `itemWeightUnit` 'LB' | 'KG': If this is an item charge, the weight measurement unit for the provided line item weight. If a preferred system of measurement was provided, the weight will be converted as necessary.
        - `rate` number: Rate used by the capacity provider to calculate this charge (e.g., an amount charged per lb, per piece, per mile, etc.). This rate may be negative (e.g., for discounts).
      - `subtotal` number: Subtotal prior to discounts, if provided.
      - `subtotalInPreferredCurrency` number: Subtotal in preferred currency prior to discounts, if provided.
      - `total` number: The final total for this quote.
      - `totalInPreferredCurrency` number: The final total for this quote, in preferred currency.
    - `requestedAccessorialServices` RequestedAccessorialService[]: A list of all accessorial services that were requested and their outcomes in this rate quote.
      - `code` string: The code for the requested accessorial service. A list of accessorial service codes supported by project44 is provided in the API reference data section.
      - `status` 'ACCEPTED' | 'ACCEPTED_UNITEMIZED' | 'UNACCEPTED': The status of the requested accessorial service -- whether or not it is reflected in the total. An outcome of 'ACCEPTED' means the capacity provider accepted the requested accessorial service, included it in their quote total, and provided a charge breakdown. An outcome of 'ACCEPTED_UNITEMIZED' means the capacity provider most likely accepted the requested accessorial service and included it in their quote total, but did not provide a verifiable charge breakdown. An outcome of 'UNACCEPTED' means the capacity provider did not accept the requested accessorial and it is not reflected in the quote total.
    - `serviceLevel` ServiceLevel: The service level offered by the capacity provider (e.g., standard or guaranteed).
      - `code` 'STD' | 'EXPEDITE' | 'EXPEDITE17' | 'EXPEDITEAM' | 'GURWIN' | 'GSSING' | 'GSMUL' | 'GSFM' | 'GS8' | 'GS9' | 'GS10' | 'GS11' | 'GSAM' | 'GS14' | 'GS15' | 'GS1530' | 'GUR' | 'ACCELERATED' | 'CAPLOAD' | 'UNKNOWN': The project44 code for this service level.
      - `description` string: A description of this service level, often originating from the capacity provider.
    - `transitDays` integer: The number of service days to deliver the shipment being quoted after it is picked up, if provided.
    - `transitDaysRange` IntegerRange: Integer Range that contains a maximum and minimum.
      - `max` integer: Maximum integer in this range.
      - `min` integer: Minimum integer in this range.

## Other responses

- `400`: Invalid request
- `401`: Invalid or missing credentials
- `403`: User not authorized to perform this operation

---

[API](https://skmtc.dev/project44/apis/project44-rest-api.md) - [All operations](https://skmtc.dev/project44/apis/project44-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/project44/apis/project44-rest-api/revisions/cdf9675e2294?raw)
