---
source_url: "https://www.safecube.ai/developers/webhook-api"
title: "Container Tracking Webhooks – Push API for Events | SafeCube"
mirrored_at: 2026-08-27T01:02:43.323Z
host: www.safecube.ai
cited_in_42a: true
mirror_canonical: "https://index.42a.ai/www.safecube.ai/developers/webhook-api"
---

> **Original source:** https://www.safecube.ai/developers/webhook-api

How it works

## Why choose Safecube’s Webhook API?

Everything you need to track and manage your container shipments in real-time, all through a single API.

### Event Triggers

Choose from a variety of events such as container arrival, departure, customs release, and delays to trigger notifications.

### Customizable Alerts

Set up specific Webhooks tailored to your needs receive only the notifications relevant to your operations.

### Global Carrier Integration

Get notifications from over 180 carriers and terminals worldwide, with real-time data integration.

### Instant Notifications

Stay updated on critical events like container arrival, delays, or customs clearance in real time.

### Seamless Integration

Effortlessly integrate our Webhooks into your existing logistics platforms and workflows.

### Event-Driven Automation

Automate your supply chain processes, triggering actions based on real-time updates without manual intervention.

![Dashboard mockup](https://cdn.prod.website-files.com/68761ebbc61ca482bd27799b/688b22c116470ae5d97be2e4_Capture_d%27%C3%A9cran_2024-09-12_122153.png)

## How It Works

Create your account and access your API key.

Define Your Events

Choose the specific container events you want to track (arrival, delays, port stops, etc.).

Set Up Webhook URL

Provide the endpoint where you’d like to receive notifications.

Automate Your Workflow

Watch as your systems are automatically updated with the latest shipping information.

APIs

## Easy Integration

### Integrate in Minutes

Our RESTful API is designed for quick and easy integration into your existing systems. Follow these simple steps:  

1.  Comprehensive Documentation
2.  Webhook Security
3.  Webhook Security
4.  Handling

Example API Call

"containers": \[  
    {  
      "number": "MSKU0496560",  
      "isoCode": "45G1",  
      "status": "IN\_TRANSIT",  
      "events": \[  
        {  
          "location": {  
            "name": "Houston",  
            "state": "Texas",

Response Format  

Our API returns data in JSON format, including:

-   Container details (ID, type, size)
-   Current location (latitude, longitude)
-   Vessel information
-   ETA and updated timestamp
-   Port of loading and discharge
-   Shipment status and events

API Input

Required Input :

MANDATORY : Shipment ID (one from the 3 possibilities)

-   Container number (seven numbers and four letters used for identifying containers internationally)
-   Booking number (usually consist of two letters and six digits)
-   Bill of Lading number (ten-digit number that's assigned by the carrier to identify the bill of lading)

Optional Input :

-   RECOMMENDED : Sealine SCAC code (4 digits alphanumeric character string, uniquely identifying the sealine)
-   RECOMMENDED : Shipment type (CT, BL or BK)
-   OPTIONAL : route (if set to true, the response will contain the route data)
-   OPTIONAL : ais (if set to true, the response will contain the ais data)

API Output

-   Metadata : sealine, status...
-   Events : description, location, vessel, facility, date...
-   Locations : name, UNLOcode, Coordinates
-   Containers : array of container data and events
-   Vessels : name, imo, mmsi...
-   Facilities
-   Route (short summary of the shipment route) : prepol, pol, pod, post pod and associated dates
-   routeData (only if requested) : succession of geographical points that can be ised to map the shipment route

Use advanced views and filters to gather your containers from Sinay’s database of 180 shipping line and 80+ million containers.

Set up alerts on any shipment via our webhooks feature  

Configure alerts on any delay or status update

Integrate data into email workflows or automatically update user dashboard

![Feature Image](https://cdn.prod.website-files.com/68761ebbc61ca482bd27799b/688b6a89e70b3f77eea52e5b_Capture%20d%E2%80%99%C3%A9cran%202025-07-31%20150704.png)

## Frequently Asked Questions

Everything about container tracking webhooks

[

Sign-up for free

](https://app.safecube.ai/auth/signup)

What is the difference between the Container Tracking API and webhooks?

The Container Tracking API is synchronous: you request data. Webhooks are asynchronous: SafeCube pushes container events to your endpoint as they happen, with no polling.

How do I verify that a webhook is authentic?

Each endpoint has a signing secret used to sign the payload. You can retrieve it and rotate it, and the previous secret stays valid for 24 hours after rotation.

What happens if my endpoint is down?

Failed messages can be resent. Recovery replays all failed messages since a given time, and replay sends messages created after a chosen timestamp without resending ones already delivered.

Can webhooks replace API calls entirely?

Yes. Used as a PUSH API, webhooks update your data automatically without any Container Tracking API request.

How do I test my endpoint before going live?

Send an example message for a specific event type. It delivers demo data rather than real tracking data, and only for events configured on that endpoint.

No credit card required • 14-day free trial • Setup in 5 minutes