# Shipment billing

> Safecube counts each unique shipment number when it is created and again at the start of every monthly billing period while it is still tracked, across the platform, webhooks and the Container Tracking API, and lists the counted shipments in Settings > Monitoring.

This page defines what counts as a billable shipment when using Safecube tracking services: the Safecube platform, the Webhooks API and the Container Tracking API. It also shows where an Owner or an Admin sees the shipments counted in each billing period. Short answers to frequent billing questions are in the [Billing and plans FAQ](/en/faq/billing).

## Billing periods

A Safecube plan is billed by period of one month, starting on the day of the subscription. A workspace that subscribed on 5 October has periods from 5 October to 5 November, then from 5 November to 5 December, and so on. The end of the current period is the **Next billing** tile of Settings > **Monitoring**.

## When a shipment is counted

A shipment is counted at most once per period:

- **when it is created**, in the app or through the API: it is counted in the current period;
- **at the start of each new period**, if it is still tracked at that moment: it is counted again in the new period.

A shipment created on 10 October and still tracked on 5 November is counted in the October period and in the November period.

## Definition of a shipment

A shipment is a **unique shipment number**: a container number, a bill of lading (BL) number or a booking (BK) number.

## Cases that count as a single shipment

- **Several tracking channels**: a shipment tracked through webhooks, the Container Tracking API and the Safecube platform counts as one shipment.
- **Different shipment types or sealines**: tracking the same shipment number with different `shipmentType` values or different sealines does not create additional billable shipments.
- **Tracking by BL or booking**: a bill of lading or a booking counts as one shipment, whatever the number of containers attached to it, as long as they stay attached to it. It is the most cost-effective way to track shipments in Safecube.

## Cases that count as several shipments

A bill of lading and its containers each created as separate shipments each count as a shipment. For example, one BL created, then its five containers created again on their own, count as six shipments.

## Non-billable and billable shipments without data

- A shipment for which Safecube **never successfully contacts the shipping line** is not billed.
- A shipment for which the shipping line is contacted successfully but **returns no data**, for example because the shipment was cancelled, is billed.

## When billing stops

A shipment is no longer counted in a new period once:

- it has reached the **Delivered** status **and** has received no new event for 7 days;
- it has been archived, manually or automatically. A shipment is archived automatically 30 days after it reaches **Delivered**, and an archived shipment is no longer billed, even if it was still in progress.

Archiving is described in [Shipment archiving](/en/platform/container-tracking/shipment-archiving), and the updates of a delivered shipment in [Update frequency](/en/platform/container-tracking/update-frequency).

### Safecube platform and Webhooks API

The Safecube platform and the Webhooks API track added shipments continuously and automatically, so their billing stops under the conditions above.

### Container Tracking API

The Container Tracking API only tracks a shipment when it is called. To stop being billed for a shipment, stop calling the Container Tracking API with its shipment number.

## See the billed shipments

Settings > **Monitoring** is open to Owners and Admins.

1. Select **Settings** at the bottom of the sidebar, then **Monitoring** under **Workspace Settings**.
2. On the **Your plan** tab, the table lists the shipments counted in the current period, with their **Shipment number** and **Counted on**, the date they were counted. Both columns can be sorted, 10 rows per page.

![Monitoring, Your plan tab of a paid workspace with the Shipment usage bar, the four plan tiles and the table of counted shipments, Shipment number and Counted on](https://docs.safecube.ai/media/images/shared/settings-monitoring--paid.webp?v=72f87b72)

3. For a past period, open the **Billing history** tab and select the eye icon, **View shipment consumptions**, on its row.

The **Billed shipments** dialog lists the shipments of that period, with **Search shipments** on the shipment number and **Export CSV**. A search with no match reads "No shipments found".

![Billed shipments dialog with the search field, the Export CSV button and the list of shipment numbers with their Counted on date](https://docs.safecube.ai/media/images/shared/modal-monitoring-shipments--default.webp?v=d4ab56da)

## Export the billed shipments

Select **Export CSV** in the **Billed shipments** dialog, or the download icon, **Export shipment consumptions**, on a row of **Billing history**. The file `Safecube_Billing_Export.csv` has two columns: `shipmentNumber` and `createdAt`, the date the shipment was counted.

## Limits

- Every export is named `Safecube_Billing_Export.csv`, whatever the period.
- The table and the export do not say why a shipment was counted, at creation or at the start of the period.
- A workspace in free trial does not see the table of counted shipments.

For questions about tracked shipments and billing, [contact the Safecube support team](https://app.safecube.ai/contact).
