Sandbox & Testing

Test Shipments

The Sandbox provides two types of test shipments. All API endpoints and parameters work identically to production, and every response has its dates automatically shifted to the current date so the tracking data always looks recent.

Static Shipments

These shipments have fixed data and do not change over time. Use them to test consistent, predictable responses.

• ZZZZ0000000 — a complete, healthy shipment (LE HAVRE → ROTTERDAM) with full event history
• ZZZZ0000001 — a provider error: the sealine could not be auto-detected (AUTO_CANT_DETECT_SEALINE)
• ZZZZ0000002 — a provider error: the sealine returned no information (SEALINE_HASNT_PROVIDE_INFO)

Dynamic Shipments

These shipments simulate real-world scenarios with evolving tracking data, including position updates, status changes, and events. Each one covers a different situation:

• ZZZZ100000 — full nominal lifecycle: PLANNED → IN_TRANSIT → DELIVERED, then resets to a new voyage
• ZZZZ200000 — a voyage with provider errors injected at some stages (e.g. SEALINE_HASNT_PROVIDE_INFO, SEALINE_UNDER_MAINTENANCE)
• ZZZZ300000 — a nominal voyage with a transhipment (LE HAVRE → ANTWERP → ROTTERDAM)

Each dynamic shipment has 7 stages. There are two ways to query them:

1. Automatic daily evolution — use the base number (10 characters), e.g. ZZZZ100000. The returned stage matches the current day of the week (Monday = 1 … Sunday = 7) and changes automatically each day, cycling weekly. Ideal for live demos that should progress on their own over time.

2. Pinned stage — append a digit 1–7 (11 characters) to freeze a specific stage, regardless of the date. Useful for deterministic, reproducible automated tests:

• ZZZZ1000001 → stage 1
• ZZZZ1000004 → stage 4
• ZZZZ1000007 → stage 7

A suffix digit greater than 7 returns 400 Bad Request.

For ZZZZ100000, the stages map as follows:

Usage

Simply use these shipment numbers in your API requests to the Container Tracking API endpoint. All API endpoints and parameters work identically to production.