Create Load - Starter Kit

curl --request POST \ --url https://{company}.datatruck.io/api/v1/openapi/orders/create/ \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data ' { "load_id": "LD-987654", "load_pay": "5000.00", "customer": "ABC Logistics", "mc_number": "Armitage", "weight": "2000kg", "goods": "Furniture", "rate_confirmation": "base64_encoded_string", "stops": [ { "company_name": "Pickup Company", "address": "123 Pickup Street", "zip_code": "10001", "enter_time": "2025-02-06T08:30:00Z", "exit_time": "2025-02-06T09:30:00Z", "reference_id": "REF-001", "stop_type": "pickup" }, { "company_name": "Delivery Company", "address": "456 Delivery Avenue", "zip_code": "20002", "enter_time": "2025-02-07T14:00:00Z", "exit_time": "2025-02-07T15:00:00Z", "reference_id": "REF-002", "stop_type": "delivery" } ] } '

{ "id": 12345, "shipment_id": "SHIP-987654", "customer": "ABC Logistics", "status": "In Progress", "mc_number": "Armitage", "load_id": "LD-987654", "references_id": "REF-123456", "load_pay": "5000.00", "total_miles": "1500.75", "tags": [ { "name": "Urgent" } ], "per_mile_revenue": "3.25", "special_instruction": "Handle with care" }

Authorizations

Authorization

string

header

required

Body

application/json

Request Body

customer

string | null

required

Customer associated with the load

Example:

"ABC Logistics"

mc_number

string

required

Motor Carrier number for the shipment

Example:

"Armitage"

load_id

string | null

Unique identifier for the load

Example:

"LD-987654"

load_pay

string<decimal> | null

Payment amount for the load

Example:

"5000.00"

weight

string | null

Weight of the goods being transported

Example:

"2000kg"

goods

string | null

Type of goods being transported

Example:

"Furniture"

rate_confirmation

string | null

Rate confirmation document in base64 format or use global url of the file)

Example:

"base64_encoded_string"

stops

object[] | null

List of stops along the route

Show child attributes

Response

Successful order creation response

integer

required

Unique order ID

Example:

12345

shipment_id

string

required

Shipment identifier

Example:

"SHIP-987654"

customer

string

required

Customer associated with the shipment

Example:

"ABC Logistics"

status

string

required

Current status of the load

Example:

"In Progress"

mc_number

string

required

Motor Carrier number for the shipment

Example:

"Armitage"

load_id

string

required

Unique identifier for the load

Example:

"LD-987654"

references_id

string

required

Reference ID for the load

Example:

"REF-123456"

load_pay

string<decimal>

required

Total payment amount for the load

Example:

"5000.00"

total_miles

string<decimal>

required

Total miles covered for the load

Example:

"1500.75"