Create Delivery

Create a delivery under the delivery capable license_number provided.

SecurityApiKeyAuth and CustomAuth

Request

path Parameters

state

required

string

Lower case ANSI standard 38:2009 USPS codes of the US state where licensee is operating.

Enum: "ca" "or" "nv" "mt" "co" "mi" "il" "ma" "ri" "nj" "md" "de" "va" "oh" "ky" "al" "ms" "mn" "la" "ok" "sd" "me"

header Parameters

x-api-key required	string Trace API key header Example: b123x21wbHlkYXBpa2V5
Authorization required	string Company and user credentials authentication Example: KMP-JSON token=dmVuZG9yLWFwaS1rZXk6dX12312sdfs2V5

Request Body schema: application/json

required	object (license_base)
estimated_departure required	string <date-time> The estimated departure date and time of the delivery.
required	object The type of delivery.
required	object The transporter details for the delivery.
required	Array of objects The orders included in the delivery.

Responses

200

400

Bad Request

post/{state}/v1/deliveries

Request samples

Payload

application/json

[{"license": {"license_number": "1231235123"
},
"estimated_departure": "2025-09-12T09:09:50Z"
},
{"delivery_type": {"id": "KOMDT0001"
},
"transporter": [{"license": null,
"license_number": "1231235123",
"vehicle": {"make": "Dodge",
"model": "Ram",
"year": null,
"color": null,
"vin": null,
"plate_number": "deliveryemp123plt"
},
"personnel": [{"first_name": "Terry",
"last_name": "Cruz",
"phone_number": "1234567890",
"driver_license_number": "dlem321dl",
"employee_license_number": "12345663"
}
]
}
],
"orders": [{"order_type": {"id": "TRCOT0001"
},
"stop_number": 1
},
{"delivery_information": null,
"consumer_id": "456_consumer",
"customer_name": "Nick",
"customer_address_1": "124 easy st",
"customer_address_2": "none",
"customer_city": "somewhereville",
"customer_county": "Larimer",
"customer_state": "CO",
"customer_zip": "90210",
"estimated_departure_time": "2025-09-12T10:09:50Z",
"estimated_arrival_time": "2025-09-12T13:09:50Z",
"route_info": "right next door"
},
{"customer_types": {"id": "DMKOMCT0002"
},
"terminal": null,
"external_id": "testing1"
},
{"created_at": {"date": "2025-09-12T19:45:00Z",
"local_time": "2025-09-12T12:45:00"
},
"identifications": [{"types": {"id": "DMKOMIT0001"
},
"id": "CADLC12356",
"birthday": "2002-02-06T00:00:01Z"
},
{"types": {"id": "DMKOMIT0002"
},
"id": "123123",
"birthday": "2000-01-01T00:00:00Z"
}
]
},
{"employees": {"id": "ef37ae8a088548b3a11cebd3d52de999"
},
"line_items": [{"lot": {"id": "1e9ab37c5f604f30a57762c2b84a8088"
},
"discount": "1.00",
"quantity": "1.00",
"unit_price": "10.00",
"taxes": [{"type": {"id": "KOMTAX0001"
},
"name": "MJ Sales Tax",
"rate": null,
"total": "1.00"
},
{"type": {"id": "KOMTAX0006"
},
"name": "MJ Municipal Tax",
"rate": null,
"total": "1.00"
}
],
"total": "11.00"
}
]
},
{"currency": {"id": "KOMCURT0001"
}
},
{"totals": {"quantity": "1.00",
"subtotal": "9.00",
"total": "11.00"
}
}
]
}
]

Response samples

application/json

{"results": {"data": {"delivery_type": {"id": "KOMDT0001"
},
"estimated_departure": "2025-09-12T09:09:50",
"license": {"license_number": "S0028"
},
"orders": [{"created_at": {"date": "2025-09-12T19:45:00",
"local_time": "2025-09-12T12:45:00"
},
"currency": {"id": "KOMCURT0001",
"name": "USD"
},
"customer_types": {"id": "DMKOMCT0002"
},
"delivery_information": {"consumer_id": "456_consumer",
"customer_address_1": "124 easy st",
"customer_address_2": "none",
"customer_city": "somewhereville",
"customer_county": "Larimer",
"customer_name": "Nick",
"customer_state": "CO",
"customer_zip": "90210",
"estimated_arrival_time": "2025-09-12T13:09:50",
"estimated_departure_time": "2025-09-12T10:09:50",
"route_info": "right next door"
},
"employees": {"id": "ef37ae8a088548b3a11cebd3d52de999"
},
"external_id": "testing1",
"id": "197f316d7fd041429b70c48915e788da",
"identifications": [{"birthday": "2002-02-06T00:00:01+00:00",
"id": "CADLC12356",
"types": {"id": "DMKOMIT0001"
}
},
{"birthday": "2000-01-01T00:00:00+00:00",
"id": "123123",
"types": {"id": "DMKOMIT0002"
}
}
],
"line_items": [{"discount": "1.00",
"lot": {"id": "1e9ab37c5f604f30a57762c2b84a8088"
},
"quantity": 1,
"taxes": [{"name": "MJ Sales Tax",
"rate": null,
"total": "1.00",
"type": {"id": "KOMTAX0001"
}
},
{"name": "MJ Municipal Tax",
"rate": null,
"total": "1.00",
"type": {"id": "KOMTAX0006"
}
}
],
"total": "11.00",
"unit_price": "10.00"
}
],
"order_number": "0000004901",
"order_type": {"id": "TRCOT0001"
},
"stop_number": 1,
"terminal": null,
"totals": {"quantity": 1,
"subtotal": "9.00",
"taxes": [{"total": 1,
"type": {"id": "KOMTAX0001",
"name": "Sales Tax"
}
},
{"total": 1,
"type": {"id": "KOMTAX0006",
"name": "Municipal Tax"
}
}
],
"total": "11.00"
}
}
],
"total_orders": 1,
"transporter": {"license": {"license_number": "S0028"
},
"personnel": [{"driver_license_number": "dlem321dl",
"first_name": "Terry",
"last_name": "Cruz",
"phone_number": "1234567890",
"employee_license_number": "12345663"
}
],
"vehicle": {"color": null,
"make": "Dodge",
"model": "Ram",
"plate_number": "deliveryemp123plt",
"vin": null,
"year": null
}
}
},
"type": "object"
},
"warnings": [ ]
}