# Track CMA CGM Shipments by B/L Number

**Use case:** 

Track a CMA CGM shipment by bill of lading number. Enter the B/L reference, with or without the CMDU prefix, and get every tracking event for the shipment's containers with date, location, vessel, voyage and actual or planned status as JSON, CSV or Excel.

## Input

```json
{
  "trackingNumbers": [
    "TYO0761099"
  ]
}
```

## Output

```json
{
  "tracking_number": {
    "label": "Tracking Number",
    "format": "text"
  },
  "events": {
    "label": "Tracking Events",
    "format": "array"
  }
}
```

## How it works

### 1. Sign up on Apify or log in

The CMA CGM Cargo Tracking Scraper Actor is ready to run with the inputs already set for "Track CMA CGM Shipments by B/L Number". [Sign up or log in](https://console.apify.com/create-task-from-example/37Aktf7Qw3L1baTYv) and you'll land in Apify Console with a copy of this exact task.

### 2. Start the "Track CMA CGM Shipments by B/L Number" task

The CMA CGM Cargo Tracking Scraper Actor will start running based on the input automatically. You can also change all the input fields, like tracking numbers, to match your specific use case.

### 3. Receive the "Track CMA CGM Shipments by B/L Number" output

Monitor the progress in real time. You will be notified as soon as your dataset is complete and ready for review. Each result includes data such as tracking number and tracking events.

### 4. Integrate into your workflow

The final output is delivered in JSON, CSV, or Excel format, ready to be plugged into your workflow. You can also [run the "Track CMA CGM Shipments by B/L Number" task via API](https://apify.com/muhammetakkurtt/cma-cgm-cargo-tracking-scraper.md).

## FAQ

### How do I track a CMA CGM shipment by bill of lading?

Enter the B/L reference, such as TYO0761099, and run this task. It returns every tracking event for the shipment's containers with date, location, vessel, voyage and status.

### Do I need the CMDU prefix in a CMA CGM B/L number?

No. B/Ls are often written with the CMDU prefix, like CMDUTYO0761099. If the full form finds nothing, the task retries without the prefix automatically.

### Does the B/L result show the container numbers?

Yes. Each event references the container it belongs to, so you can see which containers are on the B/L and follow each one from gate-out to empty return.

### Can I see the estimated arrival at destination?

Yes. Estimated and planned events, such as a forecast vessel arrival or discharge, are labeled separately from actual events that already happened.

### Can I track CMA CGM containers instead?

Yes. Container numbers work in the same field. See the Track CMA CGM Containers by Container Number task for a container example.

## About this Actor

This example demonstrates how to use [CMA CGM Cargo Tracking Scraper](https://apify.com/muhammetakkurtt/cma-cgm-cargo-tracking-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/muhammetakkurtt/cma-cgm-cargo-tracking-scraper.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/muhammetakkurtt/cma-cgm-cargo-tracking-scraper.md

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).