> For the complete documentation index, see [llms.txt](https://docs.shiptify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shiptify.com/general-overview/objects-and-ids/shipments.md).

# Shipments

### New Shipment

**Shippers**: You can’t create one <mark style="color:purple;">shipment</mark> directly. You must first create a booking (<mark style="color:blue;">Shipment request</mark>) via the API or the Platform. Then confirm it through the Platform (Only).

**Carriers**: Under certain circumstances, carriers have the ability to create a <mark style="color:purple;">shipment</mark> on behalf of their client (shippers) through the API via the endpoint *Create shipment by carrier*. If you would like to do so, please ask your Shiptify sales representative.

### Shipment status list[¶](broken://pages/G7ndyinhWf467vjnLXgl)

The following statuses are triggered by the last known tracking points.

| Status (EN) | Status (FR) |
| ----------- | ----------- |
| Planned     | Planifié    |
| In transit  | En transit  |
| Delivered   | Livré       |
| Canceled    | Annulé      |

### Shipment status diagram

<figure><img src="/files/bKhMerRklRsKInVaVGt1" alt=""><figcaption></figcaption></figure>

### Multi-containers / Multi-shipments

Usually, one <mark style="color:blue;">booking</mark> generates only one <mark style="color:purple;">shipment</mark>. But you may need to book several <mark style="color:purple;">shipments</mark> in a row for specific cases.

This is what we call Multi-containers or Multi-shipments. When such a <mark style="color:blue;">booking</mark> gets confirmed, several <mark style="color:purple;">shipments</mark> will be created in Shiptify. Each of them will have their own data or documentation attached but they can also benefit from common actions.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.shiptify.com/general-overview/objects-and-ids/shipments.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.