--- title: "Create tender" method: POST path: "/api/v2/loads/tender" tags: ["Loads"] --- # Create tender `POST /api/v2/loads/tender` Tender a load to Loadsmart. The load could be either a spot or contracted one. If the endpoint returns a successful status code, it means that we have received the load. In order to see if the load was accepted or rejected, you must listen for the `load:accepted` and `load:rejected` webhooks, respectively. See [Load Webhooks](#tag/Webhooks/paths/~1load-webhooks/post) section. Important: the uuid returned identifies a load uniquely in Loadsmart systems. This means that, for two or more responses, if they contain the same uuid, they are related to the exact same load. Quotes that have been created using the `/quote` endpoint can be booked with the tender endpoint if the `quote_id` parameter, provided by the [Create Quote](#tag/Quotes/paths/~1api~1v2~1quotes/post) endpoint, is sent. ## Request body - object - `mode` 'FTL' | 'LTL' — The transportation mode of the load. Allowed values are: - FTL: Full Truckload - LTL: Less-than-Truckload - `equipment_type` 'DRV' | 'FBE' | 'RFR' | 'CON' | 'CUR' | 'DDP' | 'IMC' | 'SDK' | 'STK' | 'BLK' | 'TNK' | 'OTH', required — Equipment required to transport the shipment. Recognized equipments are: - DRV: Dry Van - FBE: Flatbed - RFR: Reefer - CON: Conestoga - CUR: Curtainside - DDP: Double Drop - IMC: Intermodal - SDK: Step Deck - STK: Straight truck - BLK: Bulk - TNK: Tanker - OTH: Other equipment not explicited listed - `customer_ref` string, required — Internal client's reference, such as an ID, of the tender - `quote_id` string — Reference for the quote that should be used to book the load - `commodity` string — Name of the commodity that will be shipped - `source` string — Field used to indicate the context where the tender request was made (in a contract, routing guide process or spot bid, for example) - `weight` union — The total weight, in pounds, of the shipment. Acceptable values must be positive numbers with up to 2 decimal digits. Any other type will cause a validation error. Note that the minimum value is 1 and the maximum value depends on the chosen equipment_type: 45000 for DRV, 43000 for RFR and 50000 for FBE. If the weight is not provided, it is set to the maximum allowed for the equipment_type. - number - string - `stops` union[], required — Points of interest where the truck makes a stop to either pickup or deliver a shipment. Usually a tender has one pickup stop and one delivery stop, but in some cases there will be multiple delivery stops. - union - object - `type` 'PU' | 'DEL' — The type of the stop, can be PU (Pickup) or DEL (Delivery) - `facility_name` string — Name of the facility at this stop - `facility_ref` string — A reference used to identify the facility among tenders requests - `address` string - `city` string - `state` string - `zipcode` string, required - `country` string, required — 3-letter country code, uppercase (ISO 3166-1 alpha-3) - `contacts` object[] - `name` string, required — Name of the person who is the contact at this stop - `email` string, email — Email of the contact. Required if no phone number is provided - `phone_number` string — Phone number of the contact. Required if email is provided - `window_start` string, naive date-time, required — A window start indicating the start local time of the truck at the stop (required for first stop) - `window_end` string, naive date-time — A window end indicating the end local time of the truck stop at the stop - `drop_trailer` boolean — Indicates whether the truck will drop the trailer at the stop - `stop_customer_ref` string — Shipper identifier for this stop - `instructions` string — Instructions for the driver - `requirements` object — An object with specific requirements for this stop - `loading_type` 'floor_loaded' | 'palletized' — Indicates if the load should be floor loaded in this stop, or if it's palletized - object - `type` 'PU' | 'DEL' - `facility_name` string — Name of the facility at this stop - `facility_ref` string — A reference used to identify the facility among tenders requests - `stop_customer_ref` string — Shipper identifier for this stop - `address` string - `city` string, required - `state` string, required — two-letters state code - `zipcode` string - `country` string, required — 3-letter country code, uppercase (ISO 3166-1 alpha-3) - `contacts` object[] - `name` string, required — Name of the person who is the contact at this stop - `email` string, email — Email of the contact. Required if no phone number is provided - `phone_number` string — Phone number of the contact. Required if email is provided - `window_start` string, naive date-time, required — A window start indicating the start local time of the truck at the stop (required for first stop) - `window_end` string, naive date-time, required — A window end indicating the end local time of the truck stop at the stop (required for first stop) - `drop_trailer` boolean — Indicates whether the truck will drop the trailer at the stop - `instructions` string — Instructions for the driver - `contacts` object[] — At least name or phone number should be provided for each contact. - `name` string, required — Name of the person who is the contact at this stop - `email` string, email — Email of the contact. Required if no phone number is provided - `phone_number` string — Phone number of the contact. Required if email is provided - `purchase_order_numbers` object[] — Purchase Order Numbers for the load - `po_number` string — Purchase order number - `properties` object — General information about the load. This is an open JSON field that allows passing special properties with meaning on the customer context, such as the order numbers, must_arrive_by_date, and others. - `requirements` object — An object with any specific requirement for this tender - `promotion_load` boolean — Indicates the load requires expediting since customer needs the product for an in-store promotion - `emergency_response` boolean — An emergency response flag - `hazmat` boolean — Indicates that the load must consider the presence of hazardous materials - `beer` boolean — Indicates that the load requires permission to move beer - `twic` boolean — Indicates if the carrier is required to have a TWIC card - `ctpat` boolean — CTPAT recognition - `teams` boolean — Indicates if the load requires a team of drivers - `food_grade` boolean — Indicates if load requires food grade trailers - `frozen` boolean — Indicates if load requires to be moved frozen - `produce` boolean — Indicates if the load contains produce - `pharmaceuticals` boolean — Indicates if the load contains pharmaceuticals - `chemicals` boolean — Indicates if the load contains chemicals - `tsa` boolean — Indicates if the carrier is required to have a TSA card - `hvhr` boolean — Indicates if the load is high value or high risk - `vented_vans` boolean — Indicates if the load requires vented vans - `bill_to` object — An object with billing information - `company_name` string — Bill to Company Name - `address1` string — Bill to address - `address2` string — Continuation of bill to address - `city` string — Bill to city - `zipcode` string — Bill to zipcode - `state` string — Bill to state - `country` string — 3-letter country code, uppercase (ISO 3166-1 alpha-3) - `bol_number` string — the bill of lading number for the tender ## Response `200` Tender was posted - object - `data` object - `id` string, uuid, required — Unique identifier for this load. Use this id to later match with the Webhook/load with the acceptance of the load. ## Other responses - `422` — Invalid or missing data --- [API](https://skmtc.dev/loadsmart/apis/loadsmart-api.md) · [All operations](https://skmtc.dev/loadsmart/apis/loadsmart-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/loadsmart/loadsmart-api/revisions/6021c5806fe9/schema)