---
title: "Provide a rate quote in response to a shipment tender."
method: POST
path: "/api/v4/capacityproviders/tl/tenders/{tenderIdentifier}/quotes"
tags: ["TL: Capacity Provider Push"]
---

# Provide a rate quote in response to a shipment tender.

`POST /api/v4/capacityproviders/tl/tenders/{tenderIdentifier}/quotes`

## Request

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

<h4><b>Required Fields</h4></b>
<ul><li>  tenderIdentifier </li><li>  capacityProviderOfferIdentifier </li><li>  offerExpirationDateTime </li><li>  <b> rateQuoteDetail </b></li></ul>

## Path parameters

- `tenderIdentifier` string, required

## Request body

- TruckloadCapacityProviderTenderRateQuote: An object that represents a capacity provider's rate quote for a truckload tender.
  - `capacityProviderOfferIdentifier` string: This field contains the identifier that should be used to select this capacity provider's offer for dispatching.
  - `carrierIdentifier` CapacityProviderIdentifier: A capacity provider identifier object.
    - `type` 'SCAC' | 'DOT_NUMBER' | 'MC_NUMBER' | 'P44_EU' | 'SYSTEM' | 'P44_GLOBAL' | 'VAT': Capacity provider identifier type.
    - `value` string: Capacity provider identifier value.
  - `currency` 'USD' | 'CAD' | 'MXN' | 'EUR': The currency used to express the capacity provider's quoted price.
  - `equipmentIdentifiers` TruckloadEquipmentIdentifier[]: Carrier provided equipment identifiers that can be used to facilitate tracking.
    - `shouldDelete` boolean: Optional field indicating whether equipment identifier should be deleted.
    - `type` 'MOBILE_PHONE_NUMBER' | 'VEHICLE_ID' | 'LICENSE_PLATE' | 'SENSITECH_DEVICE_ID' | 'TIVE_DEVICE_ID': The type of the equipment identifier.
    - `value` string: The value of the equipment identifier. Cell phone numbers will be obfuscated in project44 responses for privacy reasons.
  - `offerExpirationDateTime` string: The expiration date time of this capacity provider offer. A time zone offset must be provided. (format: yyyy-MM-dd'T'HH:mm:ssZ, example: 2019-11-14T12:30:00-0500).
  - `rateQuoteDetail` TruckloadRateQuoteDetail
    - `charges` TruckloadVendorCharge[]: A list of individual charges making up the total. Not all capacity providers provide charge breakdowns.
      - `amount` number: The requested or actual amount charged by the capacity provider (adds into the total). This amount may be negative.
      - `description` string: The description of this charge, if provided.
      - `vendorCode` 'LH' | 'FSC': The code for this charge, as defined in the capacity provider's metadata.
    - `subtotal` number: Subtotal prior to discounts.
    - `total` number: The final total for this quote.
  - `trackingShipmentIdentifiers` TruckloadTenderTrackingShipmentIdentifier[]: Carrier provided shipment identifiers that can be used to facilitate tracking.
    - `type` 'BILL_OF_LADING' | 'ORDER' | 'TRACKING_IDENTIFIER': The type of this tendered shipment identifier.
    - `value` string: The value for this tendered shipment identifier.

## Response `200`

OK

- TruckloadCapacityProviderTenderRateQuoteConfirmation
  - `infoMessages` Message[]: System messages 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.
  - `rateQuote` TruckloadCapacityProviderTenderRateQuote: An object that represents a capacity provider's rate quote for a truckload tender.
    - `capacityProviderOfferIdentifier` string: This field contains the identifier that should be used to select this capacity provider's offer for dispatching.
    - `carrierIdentifier` CapacityProviderIdentifier: A capacity provider identifier object.
      - `type` 'SCAC' | 'DOT_NUMBER' | 'MC_NUMBER' | 'P44_EU' | 'SYSTEM' | 'P44_GLOBAL' | 'VAT': Capacity provider identifier type.
      - `value` string: Capacity provider identifier value.
    - `currency` 'USD' | 'CAD' | 'MXN' | 'EUR': The currency used to express the capacity provider's quoted price.
    - `equipmentIdentifiers` TruckloadEquipmentIdentifier[]: Carrier provided equipment identifiers that can be used to facilitate tracking.
      - `shouldDelete` boolean: Optional field indicating whether equipment identifier should be deleted.
      - `type` 'MOBILE_PHONE_NUMBER' | 'VEHICLE_ID' | 'LICENSE_PLATE' | 'SENSITECH_DEVICE_ID' | 'TIVE_DEVICE_ID': The type of the equipment identifier.
      - `value` string: The value of the equipment identifier. Cell phone numbers will be obfuscated in project44 responses for privacy reasons.
    - `offerExpirationDateTime` string: The expiration date time of this capacity provider offer. A time zone offset must be provided. (format: yyyy-MM-dd'T'HH:mm:ssZ, example: 2019-11-14T12:30:00-0500).
    - `rateQuoteDetail` TruckloadRateQuoteDetail
      - `charges` TruckloadVendorCharge[]: A list of individual charges making up the total. Not all capacity providers provide charge breakdowns.
        - `amount` number: The requested or actual amount charged by the capacity provider (adds into the total). This amount may be negative.
        - `description` string: The description of this charge, if provided.
        - `vendorCode` 'LH' | 'FSC': The code for this charge, as defined in the capacity provider's metadata.
      - `subtotal` number: Subtotal prior to discounts.
      - `total` number: The final total for this quote.
    - `trackingShipmentIdentifiers` TruckloadTenderTrackingShipmentIdentifier[]: Carrier provided shipment identifiers that can be used to facilitate tracking.
      - `type` 'BILL_OF_LADING' | 'ORDER' | 'TRACKING_IDENTIFIER': The type of this tendered shipment identifier.
      - `value` string: The value for this tendered shipment identifier.
  - `tenderIdentifier` string: The capacity provider's identifier for the tender being quoted.

## 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)