# TransportOrder

The TransportOrder is the top-level entity to model a group of related consignments that might be transported separately, but need to be administered together.

## Update transportOrder

 - [PUT /transportOrder](https://docs.transportial.com/apis/transportorder/update:transportorder.md): Update a transportOrder

## Create transportOrder

 - [POST /transportOrder](https://docs.transportial.com/apis/transportorder/create:transportorder.md): Create a new transportOrder

## Accept TransportOrder

 - [GET /transportOrder/{id}/accept](https://docs.transportial.com/apis/transportorder/accept:transportorder.md): Accept a requested transport order

## Get Trips for TransportOrder (Customer Portal)

 - [GET /transportOrder/{id}/trips:customer](https://docs.transportial.com/apis/transportorder/get:transportorder:trips:customer.md): Get trips for a transport order. Only requires get:transportOrder permission, suitable for customer portal users.

## Get Trips for TransportOrder

 - [GET /transportOrder/{id}/trips](https://docs.transportial.com/apis/transportorder/get:transportorder:trips.md): Get all trips (legs) associated with a transport order. Returns trips linked through the order's consignments, sorted by start date. Useful for viewing the execution status of forwarded orders.

## TransportOrder to Tender

 - [POST /transportOrder/{id}/tender](https://docs.transportial.com/apis/transportorder/transportorder:tender.md): TransportOrder to Tender on id

## Get transportOrders

 - [POST /transportOrders:extended/{offset}/{amount}](https://docs.transportial.com/apis/transportorder/search:transportorders.md): Get list of transportOrders

## Get transportOrder

 - [GET /transportOrder/{id}](https://docs.transportial.com/apis/transportorder/get:transportorder.md): Get a transportOrder on id

## Delete transportOrder

 - [DELETE /transportOrder/{id}](https://docs.transportial.com/apis/transportorder/delete:transportorder.md): Delete a transportOrder

## Cancel TransportOrder

 - [GET /transportOrder/{id}/cancel](https://docs.transportial.com/apis/transportorder/cancel:transportorder.md): Cancel a requested transport order

## Get extended transportOrder

 - [GET /transportOrder:extended/{id}](https://docs.transportial.com/apis/transportorder/get:transportorder_1.md): Get a transportOrder on id with extended information

## Get transportOrders with status

 - [GET /transportOrders/{status}/{offset}/{amount}](https://docs.transportial.com/apis/transportorder/get:transportorder_2.md): Get list of transportOrders with a specific status

## Get transportOrders with status

 - [GET /transportOrders:extended/{status}/{offset}/{amount}](https://docs.transportial.com/apis/transportorder/get:transportorder_3.md): Get list of transportOrders with a specific status

## Get trips for a shared transport order

 - [GET /transportOrder/{id}/{shareCode}/trips](https://docs.transportial.com/apis/transportorder/get:transportorder:public:trips.md): Returns trips linked to the transport order, filtered by the share settings visibility configuration

## Get transportOrders

 - [GET /transportOrders/{offset}/{amount}](https://docs.transportial.com/apis/transportorder/get:transportorder_4.md): Get list of transportOrders

## Get transportOrders

 - [POST /transportOrders/{offset}/{amount}](https://docs.transportial.com/apis/transportorder/search:transportorders_1.md): Get list of transportOrders

## Get transportOrder

 - [GET /transportOrder:extended/{id}/{shareCode}](https://docs.transportial.com/apis/transportorder/get:transportorder_5.md): Get a transportOrder on id with extended information

## Create transportOrder from Email

 - [PUT /transportOrder/mail/receiver](https://docs.transportial.com/apis/transportorder/create:transportorder:frommail.md): Create transportOrder from Email

## Decline TransportOrder

 - [GET /transportOrder/{id}/decline](https://docs.transportial.com/apis/transportorder/decline:transportorder.md): Decline a requested transport order

## Get transportOrder

 - [GET /transportOrder/{id}/{shareCode}](https://docs.transportial.com/apis/transportorder/get:transportorder_6.md): Get a transportOrder on id with extended information

## Duplicate transportOrder

 - [GET /transportOrder/{id}/duplicate](https://docs.transportial.com/apis/transportorder/duplicate:transportorder.md): Duplicate a TransportOrder to a new transport order

## Get transport order activity

 - [GET /transportOrder/{id}/activity](https://docs.transportial.com/apis/transportorder/handle_437.md): Get the activity timeline for a transport order

## Create transportOrder from documents

 - [POST /transportOrder/from-documents](https://docs.transportial.com/apis/transportorder/create:transportorder:fromdocument.md): Create a new transportOrder from documents

## Cancel transport orders

 - [POST /transportOrders/cancel](https://docs.transportial.com/apis/transportorder/handle_457.md): Cancel a list of transport orders

## Forward TransportOrder to Carrier

 - [POST /transportOrder/{id}/forward](https://docs.transportial.com/apis/transportorder/forward:transportorder.md): Forward an entire transport order to an external carrier. This is a simplified operation that creates a single forwarded trip for the entire order, assigned to the specified capacity contract (external carrier). For splitting into multiple legs with different carriers, use the /split endpoint instead.

## Split TransportOrder into Trips

 - [POST /transportOrder/{id}/split](https://docs.transportial.com/apis/transportorder/split:transportorder.md): Split a transport order into multiple trips (legs) for forwarding scenarios. This is used when an order needs to be executed by multiple carriers, for example: pickup carrier collects from shipper, line-haul carrier transports between hubs, delivery carrier delivers to consignee. Each leg can be assigned to a different external carrier via a capacity contract.